Link da reserva pré-preenchida, para o QR (público, com token)
POST/api/room-panel/quick-booking-link
- Auth
- Jeton requis
- Clé d’API:
- bookings:write
Les descriptions des endpoints viennent directement de la spécification de l’API et sont en portugais pour l’instant. L’interface autour est traduite.
"Reservar agora". **Não cria reserva nenhuma**: confere que o horário está livre e devolve a URL do app que abre a tela de reserva já com a sala e o horário (a pessoa confirma lá e paga do próprio saldo). O horário é o próximo bloco da sala, a pelo menos 2 minutos de agora. `durationMinutes` precisa estar em `quickDurations`. Horário ocupado: 409 com `data.nextSlots` (próximos livres); sala fechada ou duração fora das regras da sala: 409. Limite: 10 por minuto por token.
En-têtes
| Nom | Type | Description |
|---|---|---|
X-Panel-Tokenobligatoire | string | Token do painel. A comunidade e a sala saem dele; nunca vão no corpo nem no caminho. |
Corps de la requête application/json
| Nom | Type | Description |
|---|---|---|
durationMinutesobligatoire | integer |
Réponses
| Statut | Description |
|---|---|
200 | Link para o QR. |
400 | Requisição inválida — falha de validação. |
401 | Token ausente, inválido ou revogado, ou sala apagada. Nenhum dado. |
409 | Conflito com o estado atual do recurso. |
429 | Limite de taxa (60 por minuto por token, 10 por minuto em `start-meeting` e em `quick-booking-link`, 120 por minuto por IP). Traz `Retry-After` (segundos) e `errors`. |
Exemple curl
curl -X POST "https://api.memberfy.net/api/room-panel/quick-booking-link" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"durationMinutes":30}'