Что такое TelegaFirst?

AI-фронт-офис в Telegram для микробизнеса.

Где работает оператор?

Видит все важные разговоры в Telegram-супергруппе и может перехватить их одной кнопкой.

Первого бота можно попробовать бесплатно.

Для AI-агентов: markdown этой страницы — /docs/api-op-createbooking.mdиндекс документации — /llms.txt

Обновлено 4 октября 2026 г.

POST /api/v1/booking/bookings

createBooking

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	"Canonical 24-hour response receipt; resource/schedule handlers also require a key of 1..128 characters."
0.in	"header"
0.name	"Idempotency-Key"
0.required	true
0.schema	0.schema

Поле	Значение
content.application/json.schema	BookingCreateRequest
required	true

Поле	Значение
201.content.application/json.schema	Booking
201.description	"Pending booking"
201.headers.X-Bot-Username.schema	201.headers.X-Bot-Username.schema
201.headers.X-Client-Slug.schema	201.headers.X-Client-Slug.schema
201.headers.X-RateLimit-Limit.schema	201.headers.X-RateLimit-Limit.schema
201.headers.X-RateLimit-Remaining.schema	201.headers.X-RateLimit-Remaining.schema
201.headers.X-RateLimit-Reset.schema	201.headers.X-RateLimit-Reset.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"