Link da reserva pré-preenchida, para o QR (público, com token)
POST/api/room-panel/quick-booking-link
- Auth
- Token erforderlich
Die Beschreibungen der Endpoints stammen aus der API-Spezifikation und sind vorerst auf Portugiesisch. Die Oberfläche drumherum ist übersetzt.
"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.
Header
| Name | Typ | Beschreibung |
|---|---|---|
X-Panel-TokenPflicht | string | Token do painel. A comunidade e a sala saem dele; nunca vão no corpo nem no caminho. |
Request-Body application/json
| Name | Typ | Beschreibung |
|---|---|---|
durationMinutesPflicht | integer |
Antworten
| Status | Beschreibung |
|---|---|
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`. |
curl-Beispiel
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}'