API: Difference between revisions
Document the API version 2. I can't find any documentation of API version 1, nor any API documentation in https://portal.ampr.org . |
m Don't show API URLs as links. |
||
| Line 29: | Line 29: | ||
To get complete current routing information in JSON, | To get complete current routing information in JSON, | ||
request https://portal.ampr.org/api/v2/encap/routes . | request <nowiki>https://portal.ampr.org/api/v2/encap/routes</nowiki>. | ||
For example, a Unix command like this will output complete current routing information: | |||
curl -s -H "Authorization: Bearer $APItoken" -H "Accept: application/json" <nowiki>https://portal.ampr.org/api/v2/encap/routes</nowiki> | |||
The response includes a serial number, which changes when any route is updated. | |||
To get the current serial number (but not the routes) in JSON, | |||
request <nowiki>https://portal.ampr.org/api/v2/encap/serial</nowiki>. | |||
Revision as of 01:12, 15 October 2024
The AMPRNet Portal has an associated API that allows the data and functionality of the Portal to be accessed programatically.
Version 1
Version 1 of the API uses a RESTful design, accessible only via SSL (https://) to increase security.
All requests to the API require the client to authenticate by using Basic HTTP authentication, so you will need a username and password in order to access any part of the API, this can be obtained by registering for an account on the Portal.
Once you have an account, you can create your API Key (password) from the "Profile' menu link, in the "Security" section. The API username is the same username you used to login to the Portal via your web browser.
Version 2
Version 2 of the API also uses a RESTful design. Requests and responses are exchanged via HTTPS. Access is controlled using Bearer authorization. So, each request must include an HTTP header like this:
Authorization: Bearer <API Token>
To obtain an API token, register with the Portal, log in, browse your profile and copy the value of "API Token".
Some responses are in JSON format. Requests should include a header:
Accept: application/json
To get complete current routing information in JSON, request https://portal.ampr.org/api/v2/encap/routes. For example, a Unix command like this will output complete current routing information:
curl -s -H "Authorization: Bearer $APItoken" -H "Accept: application/json" https://portal.ampr.org/api/v2/encap/routes
The response includes a serial number, which changes when any route is updated. To get the current serial number (but not the routes) in JSON, request https://portal.ampr.org/api/v2/encap/serial.