The autorouter web interface is built on top of a RESTful API exporting the complete autorouter functionality. This application programming interface (API) is also available to 3rd party applications.<\/p>\n
Clients issue HTTPS requests to the autorouter server, making use of the HTTP request types GET, POST, PUT and DELETE with request specific URLs and passing input data as either HTTP parameters or JSON formatted messages in the request body. Responses can be HTTP status codes or JSON messages in the body.<\/p>\n
The API is structured around the following principal entities:<\/p>\n
Typically, operations are performed on these entities where GET retrieves information, POST creates an entity or performs an operation, PUT updates\/replaces an entity and DELETE removes an entity.<\/p>\n
The web frontend to autorouter contains an email \/ password authentication (alternatively an external OAuth 2.0 authentication from 3rd party ID providers) and uses session cookies to authenticate individual API calls during the lifetime of the session. This is typically not practical for API users which is why an additional method is offered.<\/p>\n
You will find more information on how to perform the authentication here:\u00a0Authentication via OAuth 2.0<\/a><\/p>\n The RESTful API is located at<\/p>\n for example a HTTP POST to<\/p>\n to create a new route.<\/p>\n API requests return a HTTP status\u00a0code. The following status\u00a0codes are used:<\/p>\n In most cases you will get a more descriptive error message in the body of the response.<\/p>\n The API is guaranteed to remain interface compatible in line with the Semantic Versioning<\/a>\u00a0specification\u00a0in which a version is comprised of 3 numbers in the format MAJOR.MINOR.PATCH where an increment of each component has the following meaning:<\/p>\n Some APIs are documented as “unstable<\/strong>“. For these APIs, the above interface stability guarantee does not apply. They may see incompatible changes between minor version updates. If you rely on an unstable API, please contact us to discuss your needs and how we can promote it to stable API.<\/p>\n To query the current version of the API, perform the following request<\/p>\n This returns a JSON structure containing the major and minor version number.<\/p>\n All invocations of the API contain the major and minor number as part of the URL (https:\/\/api.autorouter.aero\/v1.0). This allows the platform to introduce changes to the API but maintain backwards compatibility by continuing to provide the previous version of the API which requires knowing which version of the API the client expects. If you omit the version number, the server will assume the latest version of the API. It is beneficial to check back regularly for the latest API revision and adapt your application to make use of it. This will both give you access to added capabilities and keep you close to development so that when a major update happens and a previous version is finally retired from service, you most likely won’t have to make any changes or only small changes to your application.\u00a0The API changes for each version number are documented in the API changelog<\/a>.<\/p>\n Certain events trigger messages that clients can subscribe to using the message queue facility<\/a>.<\/p>\nAPI invocation<\/h1>\n
https:\/\/api.autorouter.aero\/v1.0\/<group>\/<request><\/pre>\n
https:\/\/api.autorouter.aero\/v1.0\/router<\/pre>\n
\n
\nRequest completed successfully.<\/li>\n
\nInvalid request data. Some of the data passed to the call is not valid.<\/li>\n
\nNot authorized. You did either supplier no credentials, expired credentials or invalid credentials. You can try the request again with correct credentials.<\/li>\n
\nAccess denied. You do not have permission to access the resource or perform the operation. Repeating the request will not help.<\/li>\n
\nObject not found. Most likely an object referenced through the request URL was not found or could not be accessed due to insufficient privileges (the API will not tell you that for security reasons).<\/li>\n
\nInternal error processing the request. This shouldn’t really happen so we’re grateful for reports and scenarios where this happens.<\/li>\n
\nThe server cannot handle the request at the given time due to capacity issues. The request should be attempted again at a later time. If the issue is frequent or prevails over a longer period of time, a support ticket should be opened.<\/li>\n<\/ul>\nVersioning<\/h1>\n
\n
\nWhen incompatible API changes are made.<\/li>\n
\nWhen functionality is added in a backwards-compatible manner.<\/li>\n
\nWhen backwards-compatible bug fixes are applied.<\/li>\n<\/ul>\nHTTP GET https:\/\/api.autorouter.aero\/v1.0\/system\/version<\/pre>\n
{\n \"major\": 1,\n \"minor\": 0<\/span>,\n \"patch\": 19,\n \/* whether this is a production system (false for test\/sandbox system) *\/\n \"production\": true,\n \/* the minimum version of the API supported by the server *\/\n \"minVersion\":\n {\n \"major\": 1,\n \"minor\": 0\n },\n \/* whether the system considers the call to be authenticated *\/\n \"auth\": false\n}<\/pre>\nMessages<\/h1>\n
Samples<\/h1>\n