Создание клиентской карты
POST
/v1/client-card
const url = 'https://api-admin.billz.ai/v1/client-card';const options = { method: 'POST', headers: { 'platform-id': '7d4a4c38-dd84-4902-b744-0488b80a4c01', Authorization: 'Bearer <token>', 'Content-Type': 'application/json' }, body: '{"customer_id":"00000000-0000-0000-0000-000000000000"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}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 — общие для всех методов. Форматы тела и семантика — Коды ответов и ошибки.
Authorizations
Заголовок раздела «Authorizations»Parameters
Заголовок раздела «Parameters»Header Parameters
Заголовок раздела «Header Parameters»platform-id
string
Идентификатор платформы. Для интеграций используется статичное значение.
Request Bodyrequired
Заголовок раздела «Request Bodyrequired»Media typeapplication/json
object
customer_id
required
Идентификатор клиента, которому создаётся карта.
string format: uuid
Example
{ "customer_id": "00000000-0000-0000-0000-000000000000"}Responses
Заголовок раздела «Responses»Успешный ответ
Media typeapplication/json
object
id
Идентификатор клиента из запроса (не идентификатор карты)
string format: uuid
card_code
Сгенерированный код карты (штрихкод)
string
Examplegenerated
{ "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "card_code": "example"}