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

Создание клиента

POST
/v1/client
curl --request POST \
--url https://api-admin.billz.ai/v1/client \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'platform-id: 7d4a4c38-dd84-4902-b744-0488b80a4c01' \
--data '{ "chat_id": "some_chat_id", "date_of_birth": "2022-05-14", "first_name": "John", "gender": 1, "last_name": "Doe", "phone_number": "+998000000000" }'

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

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

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

Media typeapplication/json
object
id
string
phone_number

Номер телефона; сохраняется как единственный элемент phone_numbers клиента

string
first_name

Имя

string
last_name

Фамилия

string
gender

Пол: 1 — мужской, 2 — женский; иное значение — не задан

integer format: int32
date_of_birth

Формат 2022-05-14

string
chat_id

Telegram chat_id

string
Example
{
"chat_id": "some_chat_id",
"date_of_birth": "2022-05-14",
"first_name": "John",
"gender": 1,
"last_name": "Doe",
"phone_number": "+998000000000"
}

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

Media typeapplication/json
object
id

Идентификатор созданного клиента

string format: uuid
Examplegenerated
{
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
}