Link da reserva pré-preenchida, para o QR (público, com token)
POST/api/room-panel/quick-booking-link
- Auth
- Requiere token
Las descripciones de los endpoints vienen de la especificación de la API y, por ahora, están en portugués. La interfaz alrededor está traducida.
"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.
Headers
| Nombre | Tipo | Descripción |
|---|---|---|
X-Panel-Tokenobligatorio | string | Token do painel. A comunidade e a sala saem dele; nunca vão no corpo nem no caminho. |
Cuerpo de la solicitud application/json
| Nombre | Tipo | Descripción |
|---|---|---|
durationMinutesobligatorio | integer |
Respuestas
| Código | Descripción |
|---|---|
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`. |
Ejemplo 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}'