API Reference
Base URL
Section titled “Base URL”https://tiles.fenod.frAuthentication
Section titled “Authentication”All /v1/* endpoints require an API key passed as a query parameter:
?key=YOUR_API_KEYKeys are created in the dashboard and scoped to specific domains.
Endpoints
Section titled “Endpoints”Get style
Section titled “Get style”GET /v1/styles/{flavor}.json?key=KEYReturns a MapLibre Style Specification JSON document. The style includes authenticated tile source URLs so no further key handling is needed on the client.
Available flavors: light, dark, streets, minimal, corporate
Get TileJSON metadata
Section titled “Get TileJSON metadata”GET /v1/tiles/{name}.json?key=KEYReturns TileJSON metadata for a tileset.
Available tilesets: planet
Get vector tile
Section titled “Get vector tile”GET /v1/tiles/{name}/{z}/{x}/{y}.mvt?key=KEYReturns a single vector tile in Mapbox Vector Tile (MVT) format.
| Parameter | Description |
|---|---|
name | Tileset name |
z | Zoom level (0-14) |
x | Tile column |
y | Tile row |
Get font glyphs
Section titled “Get font glyphs”GET /fonts/{fontstack}/{range}.pbfReturns Signed Distance Field (SDF) font glyphs for text rendering. No authentication required.
Get sprites
Section titled “Get sprites”GET /sprites/{version}/{file}Returns sprite sheets used for map icons and patterns. No authentication required.
Health check
Section titled “Health check”GET /healthReturns service status. No authentication required.
Rate limits
Section titled “Rate limits”Requests are rate-limited per calendar month based on your plan:
| Plan | Monthly requests | Price |
|---|---|---|
| Starter | 50,000 | 9/mo |
| Pro | 500,000 | 29/mo |
| Business | 5,000,000 | 79/mo |
Response headers
Section titled “Response headers”All tile responses include:
Cache-Control— caching directives for CDN and browser cachingAccess-Control-Allow-Origin— CORS header matching the allowed domainContent-Type— MIME type of the response (application/x-protobuffor MVT,application/jsonfor style/TileJSON)
Error responses
Section titled “Error responses”| Status | Meaning |
|---|---|
400 | Bad request — invalid parameters |
401 | Unauthorized — missing or invalid API key |
404 | Not found — tileset or resource does not exist |