Référence API

URL de base

https://tiles.fenod.fr

Authentification

Tous les endpoints /v1/* nécessitent une clé API passée en paramètre de requête :

?key=VOTRE_CLE_API

Les clés sont créées dans le tableau de bord et restreintes à des domaines spécifiques.

Endpoints

Obtenir un style

GET /v1/styles/{flavor}.json?key=KEY

Retourne un document JSON conforme à la spécification MapLibre Style. Le style inclut les URLs de tuiles authentifiées, aucune gestion de clé supplémentaire n’est nécessaire côté client.

Styles disponibles : joyful, grayscale, ink, newspaper, blueprint

Obtenir les métadonnées TileJSON

GET /v1/tiles/{name}.json?key=KEY

Retourne les métadonnées TileJSON d’un jeu de tuiles.

Jeux de tuiles disponibles : planet

Obtenir une tuile vectorielle

GET /v1/tiles/{name}/{z}/{x}/{y}.mvt?key=KEY

Retourne une tuile vectorielle au format Mapbox Vector Tile (MVT).

Paramètre	Description
`name`	Nom du jeu de tuiles
`z`	Niveau de zoom (0-14)
`x`	Colonne de la tuile
`y`	Ligne de la tuile

Obtenir les glyphes

GET /fonts/{fontstack}/{range}.pbf

Retourne les glyphes SDF (Signed Distance Field) pour le rendu du texte. Pas d’authentification requise.

Obtenir les sprites

GET /sprites/{version}/{file}

Retourne les feuilles de sprites utilisées pour les icônes et motifs de la carte. Pas d’authentification requise.

Vérification de santé

GET /health

Retourne le statut du service. Pas d’authentification requise.

Limites de requêtes

Les requêtes sont limitées par mois calendaire selon votre forfait :

Forfait	Requêtes mensuelles	Prix
Starter	50 000	9€/mois
Pro	500 000	29€/mois
Business	5 000 000	79€/mois

En-têtes de réponse

Toutes les réponses de tuiles incluent :

Cache-Control — directives de cache pour CDN et navigateur
Access-Control-Allow-Origin — en-tête CORS correspondant au domaine autorisé
Content-Type — type MIME de la réponse (application/x-protobuf pour MVT, application/json pour style/TileJSON)

Réponses d’erreur

Statut	Signification
`400`	Requête invalide — paramètres incorrects
`401`	Non autorisé — clé API manquante ou invalide
`404`	Non trouvé — jeu de tuiles ou ressource inexistant