Api
Styles API
Serve published MapLibre style JSON with stable and versioned Planisfy URLs.
Styles API
Published styles return MapLibre style JSON snapshots.
Routes
| Method | Route | Description |
|---|---|---|
GET | /styles/v1/{owner}/{style} | Current published style for the stable alias. |
GET | /styles/v1/{owner}/{style}@{version} | A specific published style version. |
{version} must be a positive integer. Stable URLs resolve the latest publication alias. Version URLs resolve the matching published snapshot.
Example
curl "https://api.example.com/styles/v1/acme/streets"MapLibre can use the URL directly:
const map = new maplibregl.Map({
container: "map",
style: "https://api.example.com/styles/v1/acme/streets",
center: [9.1829, 48.7758],
zoom: 12
});Auth
Public styles can be read anonymously. Private styles require owner context from a valid API key or session. Forbidden private reads return 403 FORBIDDEN.
Caching
Public styles return Cache-Control: public, max-age=300 and an ETag. Private styles return private, no-cache.