API

The catalogs behind RouteConverter live at api.routeconverter.com: the shared route catalog (categories, routes and route files), the datasources and editions behind the map and theme downloads, and the map and overlay tile servers the app offers. The RouteConverter app reads them, and so can you.

• API documentation (Swagger UI): browse every endpoint with its parameters and responses, and try read requests right in the browser.
• OpenAPI 3 schema (YAML, or JSON): generate a client from it or import it into your tools.
• API root: the list of catalog endpoints.

Good to know

• The RouteConverter app exchanges XML (Accept: application/xml); JSON is served too. The element names in the XML differ from the JSON field names in the schema.
• Reading is anonymous. Writing to the route catalog needs a RouteConverter account, sent with HTTP Basic authentication.
• "Try it out" on the documentation page sends real requests to the production server, so it is limited to reads.
• Questions or ideas? Ask in the forum.