Cancela a reserva
POST/api/bookings/{bookingId}/cancel
- Auth
- Requiere token
- X-CommunityId
X-CommunityIdEnvía el X-CommunityId de la comunidad en la que ocurre la operación.
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.
Dono, anfitrião e equipe. Reserva que já começou não cancela (400); a equipe a marca `NO_SHOW`. O dono cancelando depois da janela da comunidade (padrão 24 h, ou a do recurso), ou numa reserva já marcada `lateCancel` ao ser remarcada dentro da janela, marca `lateCancel` e perde os créditos conforme `lateCancelLosesCredits`; dentro da janela, estorno integral ao mesmo lote. Cancelamento da equipe ou do anfitrião estorna sempre tudo e nunca é tardio. O `reason` vai no e-mail.
Parámetros
| Nombre | Dónde | Tipo | Descripción |
|---|---|---|---|
bookingIdobligatorio | path | string (uuid) |
Headers
| Nombre | Tipo | Descripción |
|---|---|---|
X-CommunityIdopcional | string (uuid) | ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade. |
Cuerpo de la solicitud application/json
| Nombre | Tipo | Descripción |
|---|---|---|
reasonopcional | string | max 255 |
Respuestas
| Código | Descripción |
|---|---|
200 | Cancelada. |
400 | Requisição inválida — falha de validação. |
401 | Token ausente, inválido ou expirado. |
404 | Recurso não encontrado. |
409 | Conflito com o estado atual do recurso. |
500 | Erro interno do servidor. |
Ejemplo con curl
curl -X POST "https://api.memberfy.net/api/bookings/<bookingId>/cancel" \
-H "Authorization: Bearer $TOKEN" \
-H "X-CommunityId: $COMMUNITY_ID" \
-H "Content-Type: application/json" \
-d '{}'