Link da reserva pré-preenchida, para o QR (público, com token)
POST/api/room-panel/quick-booking-link
- Auth
- Richiede un token
Le descrizioni degli endpoint provengono dalla specifica dell’API e per ora sono in portoghese. L’interfaccia intorno è tradotta.
"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
| Nome | Tipo | Descrizione |
|---|---|---|
X-Panel-Tokenobbligatorio | string | Token do painel. A comunidade e a sala saem dele; nunca vão no corpo nem no caminho. |
Corpo della richiesta application/json
| Nome | Tipo | Descrizione |
|---|---|---|
durationMinutesobbligatorio | integer |
Risposte
| Codice | Descrizione |
|---|---|
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`. |
Esempio con 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}'