New SL API ”Public transport information Region Stockholm” replacing
today’s 7 SL APIs at Trafiklab

SL launched its first open APIs in 2014 and today there are 7 APIs with a functionality that has gradually been extended.

You’ve been using these services and we’ve received valuable feedback that has been used as part of the basis for the design of the new open SL API.

The key words when designing the new API have been simplicity, consistency, standardized and more extensive.

The new SL API will replace the current 7 APIs and offer a consistent data model throughout the whole API.

You are no longer required to know that Slussen has the id 9192 in order to find the next departure. Just search for Slussen and you’ll get next departure, deviations and the actual lines.
Searching could be done for the whole station or for a single stop point.

The API is RESTful and supports HATEOAS implying simpler error handling and navigation of information.

The structure of the API is future-proof and facilitates the addition of traffic information such as entrance points, vehicle positions etc.
Documentation and version handling will also be improved – you won’t need to retrieve a new key for each new version of the API.

Summary:

  • API capabilities
    • Trip search
    • Stop areas and Lines
    • Deviations
    • Next departure
    • Auto completion
  • RESTful (supporting HATEOAS)
  • Consistent data model
  • Improved documentation
  • More precise and standardized error messages
  • One single API key no matter the endpoint or the API version
  • Enables faster change of consuming applications

 

The migration of applications currently using the SL APIs will be possible during a transition period of 4 months when these APIs will coexist with the new SL API.

Thereafter, only the new SL API will be available.

We’ll keep you updated with additional information about the time schedule for the new SL API with its parameters and corresponding response data. The new SL API is planned to be launched in the autumn of 2020.

For any questions, please contact Trafiklab via Kundo at trafiklab.se.