Mijoz kartasini yaratish

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" }'

Mijozga yaratilgan kodli yana bitta karta chiqaradi. Birinchi karta mijoz bilan birga yaratiladi (POST /v1/client), shuning uchun chaqiruvdan keyin mijozda ikkita karta bo’ladi, har bir keyingi chaqiruv esa yana bittasini qo’shadi.

Javobdagi id — kartaning emas, mijozning identifikatori. Mijozning kartalari GET /v1/customer/{id} javobidagi cards da.

Xato kodlari: 400 — kiruvchi ma’lumotlar validatsiya xatosi; 401, 403, 429, 500 — barcha metodlar uchun umumiy. Tana formatlari va semantikasi: Javob kodlari va xatolar.

Authorizations

BearerAuth

Parameters

Header Parameters

platform-id

string

default: 7d4a4c38-dd84-4902-b744-0488b80a4c01

Platforma identifikatori. Integratsiyalar uchun statik qiymat ishlatiladi.

Request Body^required

application/json

object

customer_id

required

Karta yaratilayotgan mijoz identifikatori.

string format: uuid

Example

{
  "customer_id": "00000000-0000-0000-0000-000000000000"
}

Responses

200

Muvaffaqiyatli javob

application/json

object

So’rovdagi mijoz identifikatori (karta identifikatori emas)

string format: uuid

card_code

Yaratilgan karta kodi (shtrix-kod)