samedi API Reference

Instant Booking

The Resource Owner (user) must grant authorization to the Client before the Client can book appointments on the user’s behalf. This requires that the Client forwards the Resource Owner to the samedi Authorization endpoint. There are 2 possibilities:

1. The Resource Owner already has a samedi patient account

In this case the user logs in to samedi and after successful login is redirected to the Client-specified Redirect URI. The Client application/service can now access the user’s resources without any time restrictions.

2. The Resource Owner has no samedi account

In that case the user is able to sign up for a samedi account and then to authorize the Client for that account. Afterwards it is forwarded to the Client-specified Redirect URI. The Client can afterwards book appointments on the user’s behalf but only for a time frame of 30 minutes. To increase this time window and continue to access the user’s protected resources the user has to first complete the activation process (information are being sent via email).