Project

General

Profile

Actions

OpenAtlas API

OpenAtlas provides an API which is RESTlike to easily access data entered in OpenAtlas.
A complete overview of possible endpoints and usage is available at our swagger documentation.

Versioning

The OpenAtlas API tries to follow REST principles, but OpenAtlas provides multiple versions of the API
  • Deprecated version (currently API 0.2)
  • Stable version (currently API 0.3)
    • No breaking changes will be made, but new features and additions may be added
    • Deprecation of endpoints and parameters will be marked for next versions

Error handling

The OpenAtlas API provides two layers of errors catching.
  • First layer: validates a given parameter of an endpoint. Errors are caught by the Flask-RESTful extension, which has its own error handler.
  • Second layer: is a self build error model, for details see: API Error Handling

Output format

Please see API Output Formats for specifications.
  • LinkedPlacesFormat (LPF) with extensions for OpenAtlas (standard)
  • A simpler GeoJSON format
  • RDF (derived from LPF, maybe incomplete)
    • XML
    • Pretty-XML
    • Turtle
    • Notion 3
    • N-Triples

Endpoints

Overview of available endpoints: Endpoints
The API can be accessed via the following schema: {domain}/api/{api version}/{endpoint} for example: demo.openatlas.eu/api/0.3/entity/1234

OpenAtlas backend

If advanced layout is selected in your profile, a link to the different formats of entities is shown on their specific page.
If the option Public is activated in site settings (default is off) the API can be used even when not logged in.

Parameters

Overview of all parameters used in different versions: Parameters
Endpoints can take in multiple parameters entered after the URL e.g.: demo-openatlas.eu/api/code/actor?sort=desc&limit=300

The first parameter has to have a ? to mark the parameter sections begin. More parameters can be added with &.

api/code/actor?sort=desc&limit=300

Cross-Origin Resource Sharing

Please visit CORS for more information.

Related OpenAtlas API links

Resources

general development

Versioning

Updated by Bernhard Koschiček-Krombholz 2 months ago · 137 revisions

Also available in: PDF HTML TXT