samedi API Reference

General Troubleshooting

The API makes use of meaningful HTTP status codes and error messages in order to facilitate possible troubleshooting. Error messages specific to individual endpoints have already been described in the corresponding sections. The following table lists some generic errors and their cause.

Error Status Code Description
Unauthorized 401 Invalid (or missing) Client ID or Access Token
This method is only available via POST 405 A POST method was called via a GET request
This method is only available via GET 405 A REST method was called via a POST request
attendant must have an external_user_id 400 Attempted to book an appointment without a patient user for an appointment type which does not allow that. Either book the appointment with a patient user (complete the OAuth process) or configure the appointment type accordingly.

Feedback and Information

Should you need further information or would like to share your feedback with us please contact us on technical-support@samedi.de.

Sample Implementation

You can find a sample implementation of the Booking API including patient authentication via OAuth at samedi’s GitHub Rails Booking API repository