Перейти к содержимому

Создание клиентской карты

POST
/v1/client-card
curl --request POST \
--url https://api-admin.billz.ai/v1/client-card \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'platform-id: 7d4a4c38-dd84-4902-b744-0488b80a4c01' \
--data '{ "customer_id": "00000000-0000-0000-0000-000000000000" }'

Выпускает клиенту ещё одну карту со сгенерированным кодом. Первая карта создаётся вместе с клиентом (POST /v1/client), поэтому после вызова у клиента две карты, а каждый следующий вызов добавляет ещё одну.

id в ответе — идентификатор клиента, а не карты. Карты клиента — в cards ответа GET /v1/customer/{id}.

Коды ошибок: 400 — ошибка валидации входных данных; 401, 403, 429, 500 — общие для всех методов. Форматы тела и семантика — Коды ответов и ошибки.

platform-id
string
default: 7d4a4c38-dd84-4902-b744-0488b80a4c01

Идентификатор платформы. Для интеграций используется статичное значение.

Media typeapplication/json
object
customer_id
required

Идентификатор клиента, которому создаётся карта.

string format: uuid
Example
{
"customer_id": "00000000-0000-0000-0000-000000000000"
}

Успешный ответ

Media typeapplication/json
object
id

Идентификатор клиента из запроса (не идентификатор карты)

string format: uuid
card_code

Сгенерированный код карты (штрихкод)

string
Examplegenerated
{
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"card_code": "example"
}