Epicollect5 API

Epicollect5 is currently a read only api. Only GET requests are exposed to third party clients/apps.

Adding/editing resources can be done only via Epicollect5 official applications (Android, iOS, web).

Only secure https requests are allowed.

Server responses:

  • 200 OK the request was successful.
  • 400 Bad Request the request could not be understood or was missing required parameters.
  • 404 Not Found the resource was not found.
  • 500 Internal Server Error something unexpected happened

Status code responses

When an error occurs, you will receive a status code in the response.

Error objects are returned in the standard JSON API format and consist of:

  • code - the EC5 code
  • title - a title for the EC5 code (in English)
  • source - the source of the response

A full list of the available status codes can be found here.

Rate limiting

We currently limit accessing the API to 60 requests per minute.

Authentication

For PRIVATE projects, access to data is restricted.

In order to access the data, you need to create an Epicollect5 Client App and generate an API Token, which can be added to all requests made via the Authorization header, like so:

Authorization: Bearer {api_token}

This can be done from the Project Details page by the Creator or Manager of a Project.

results matching ""

    No results matching ""