Компактный API записи с ограниченными правами.

Конечные точки

Авторизация, конверты и трассировка запросов

GET /api/partner/v1/catalog?locale=en&limit=2 HTTP/1.1
Authorization: Bearer fnx_test_example_key_not_a_real_credential
Accept-Language: en
Origin: https://partner.example

HTTP/1.1 200 OK
Cache-Control: private, no-store
Referrer-Policy: no-referrer
X-Request-Id: <request_id>
X-RateLimit-Limit: <limit>
X-RateLimit-Remaining: <remaining>
X-RateLimit-Reset: <unix_seconds>

{
  "data": { "services": [], "next_cursor": null },
  "meta": { "request_id": "<request_id>", "version": "v1" }
}

Политика scope и учётных данных

Создание записи

POST /api/partner/v1/bookings HTTP/1.1
Authorization: Bearer fnx_test_example_key_not_a_real_credential
Idempotency-Key: 7b1d9ed1-7f34-4ddf-9e01-example
Content-Type: application/json

{
  "service_id": "<published_service_id>",
  "location_id": "<optional_allowed_location_id>",
  "date": "2026-09-21",
  "start_time": "10:00",
  "external_reference": "partner-order-1042",
  "customer": {
    "name": "Test customer",
    "phone": "+15550001111",
    "consent_to_contact": true
  }
}

Текущая структура записи

• Partner API v1 создаёт одну услугу на запись. Документированное поле service_id является одиночным; выдуманные поля service_ids или composition_mode отклоняются.
• Составная последовательная или параллельная запись доступна через подписанный виджет Feny и собственный поток записи, где канонический механизм проверяет комбинации, вместимость персонала и текущие правила бизнеса.
• Не раскрывайте учётные данные Partner API в коде браузера. Для встраивания используйте публичные id и версию виджета, а вызовы API выполняйте на доверенном сервере.

Пагинация и ограниченное чтение

GET /api/partner/v1/catalog?locale=en&limit=25&cursor=<next_cursor> HTTP/1.1
Authorization: Bearer fnx_test_example_key_not_a_real_credential

{
  "data": {
    "services": ["..."],
    "next_cursor": "<opaque_cursor_or_null>"
  },
  "meta": { "request_id": "<request_id>", "version": "v1" }
}

Правила пагинации

• Чтение каталога и специалистов принимает limit от 1 до 50 (по умолчанию 25). Доступность принимает от 1 до 96 (по умолчанию 48).
• Передавайте next_cursor точно в полученном виде. Он непрозрачный: его нельзя декодировать, создавать, передавать между несвязанными запросами или использовать после смены фильтров.
• next_cursor доступности обозначает время начала последнего возвращённого слота именно для этого запроса. null означает, что следующей страницы нет.
• Доступность является текущим чтением, а не резервированием. Прочитайте её снова и позвольте запросу создания выполнить финальную серверную проверку вместимости.

Идемпотентные действия с записью

POST /api/partner/v1/bookings/<pbr_reference>/actions/cancel HTTP/1.1
Authorization: Bearer fnx_test_example_key_not_a_real_credential
Idempotency-Key: 11111111-2222-4333-8444-example
Content-Type: application/json

{ "expected_version": 3 }

Политика идемпотентности и версий

• Используйте один Idempotency-Key на 16–128 символов для одной логической операции записи. После неопределённого результата повторите точный запрос; для новой операции создайте новый ключ.
• Никогда не используйте ключ идемпотентности повторно с изменёнными данными. API возвращает 409 idempotency_key_reused вместо предположений о главном запросе.
• Получите управляемую запись перед отменой или переносом и передайте последнюю версию как expected_version. Устаревшая версия может вернуть 409 booking_version_conflict.
• Не кодируйте данные клиента, учётные данные или другие чувствительные значения в Idempotency-Key или external_reference.

Ошибки и повторные попытки