Для AI-агентов: markdown этой страницы — /docs/api-op-cancelbooking.md · индекс документации — /llms.txt
cancelBooking
Обновлено
POST /api/v1/booking/bookings/{seqNum}/cancel
cancelBooking
#Авторизация и права
Scopes: ALL. Auth alternatives: OR; scopes внутри альтернативы: ALL.
| Поле | Значение |
|---|
| security.0.hubApiKey | [] |
| security.1.hubBearer | [] |
| securitySchemes.hubApiKey.in | "header" |
| securitySchemes.hubApiKey.name | "X-Api-Key" |
| securitySchemes.hubApiKey.type | "apiKey" |
| securitySchemes.hubBearer.scheme | "bearer" |
| securitySchemes.hubBearer.type | "http" |
| x-required-scopes | ["booking:write"] |
#Параметры запроса
| Поле | Значение |
|---|
| 0.description | "Required when the cancel body contains a reason; empty {} and an absent or empty header bypass the global cache." |
| 0.in | "header" |
| 0.name | "Idempotency-Key" |
| 0.required | false |
| 0.schema | 0.schema |
| 1.in | "path" |
| 1.name | "seqNum" |
| 1.required | true |
| 1.schema | 1.schema |
#Тело запроса
#Ответы
#Ошибки
| Поле | Значение |
|---|
| 400.content.application/problem+json.schema | ProblemDetails |
| 400.description | "Actual body/param/query pipe rejects the request, or global Idempotency-Key is absent" |
| 401.content.application/problem+json.schema | ProblemDetails |
| 401.description | "Missing, invalid, expired or revoked authentication" |
| 403.content.application/problem+json.schema | ProblemDetails |
| 403.description | "Required ALL scopes, plan or resource policy refused the caller" |
| 404.content.application/problem+json.schema | ProblemDetails |
| 404.description | "Canonical facade could not resolve a resource, schedule, catalog, booking or user in this tenant" |
| 409.content.application/problem+json.schema | ProblemDetails |
| 409.description | "Control-plane conflict, stale resource/schedule version, invalid schedule cursor or global request already processing" |
| 413.content.application/problem+json.schema | ProblemDetails |
| 413.description | "Per-tool payload size or item count exceeded" |
| 422.content.application/problem+json.schema | ProblemDetails |
| 422.description | "Generic global idempotency receipt was reused with a different request body" |
| 429.content.application/problem+json.schema | ProblemDetails |
| 429.description | "Per-tool rate limit exceeded or unavailable" |
| 429.headers.Retry-After.description | "Resource guard retry delay when supplied by the limiter" |
| 429.headers.Retry-After.schema | 429.headers.Retry-After.schema |
| 500.content.application/problem+json.schema | ProblemDetails |
| 500.description | "Unexpected failure reaches the canonical Problem Details filter" |
#Дополнительные условия
| Поле | Значение |
|---|
| operationId | "cancelBooking" |
| tags | ["booking"] |
| x-idempotency | "http-cache" |
| x-pagination | null |