
API Documentation
"Astro Otter" expose a read-only Rest-full API and offer to you its data. You can use for your own website or application.
You only need a bearer token by register with the form below. The supported response types are only JSON.
You only need a bearer token by register with the form below. The supported response types are only JSON.
Ask for token
List of endpoints
Retrieve token :
curl -X POST -H "Content-Type: application/json" https://astro-otter.space/api/auth/login -d '{"username": "YOUR-USERNAME", "password": "YOUR-PASSWORD"}'
This request return your token and a refresh token. Token is available 1 month. After that, when your JWT valid token expires, if you want to get a new one you can proceed in two ways :
- Send you user credentials again to https://astro-otter.space/api/auth/login. This generates another JWT with another Refresh Token.
Get object by Id :
curl -X GET -H 'Authorization: Bearer YOUR-TOKEN' https://astro-otter.space/api/dso/item/M31
Get objets with many parameters
curl -X GET -H 'Authorization: Bearer YOUR-TOKEN' https://astro-otter.space/api/dso/list?catalog=messier&constellation=Ori&offset=5&limit=5