Base URL
The Mitwirken API is built on REST principles. We enforce HTTPS in every request to improve data security, integrity, and privacy. The API does not support HTTP. All requests contain the following base URL:Authentication
To authenticate you need to add an Authorization header with the contents of the header beingBearer mit_123456789 where mit_123456789 is your API Key.
Response codes
Mitwirken uses standard HTTP codes to indicate the success or failure of your requests. In general,2xx HTTP codes correspond to success, 4xx codes are for user-related failures, and 5xx codes are for infrastructure issues.
Check Error Codes for a comprehensive breakdown of all possible API errors.
Rate limit
The response headers describe your current rate limit following every request in conformance with the IETF standard:
The default maximum rate limit is 2 requests per second. This number can be increased for trusted senders by request.
After that, you’ll hit the rate limit and receive a
429 response error code.
To prevent this, we recommend reducing the rate at which you request the API. This can be done by introducing a queue mechanism or reducing the number of concurrent requests per second. If you have specific requirements, contact support to request a rate increase.
FAQ
How does pagination work with the API?
How does pagination work with the API?
We do not support pagination yet.
How do you handle API versioning?
How do you handle API versioning?
We do not support API versioning yet.