Guruhlar API

Kampaniyalaringiz uchun kontakt guruhlarini boshqaring.

POST /api/groups

Yangi kontakt guruhi yarating.

json

{
  "name": "VIP Customers",
  "description": "High-value clients"
}

json

{
  "id": "group-uuid",
  "name": "VIP Customers",
  "description": "High-value clients",
  "clientCount": 0,
  "createdAt": "2024-01-15T10:00:00Z"
}

GET /api/groups

Barcha guruhlarni paginatsiya bilan ko'rsating.

bash

curl -H "Authorization: Bearer $TOKEN" \
  "https://api.xabarchi.live/api/groups?page=1&limit=20"

POST /api/groups/:id/clients

Guruhga mijoz qo'shing.

json

{
  "phoneNumber": "+998901234567",
  "name": "John Doe"
}

Eslatma: Telefon raqam formatda bo'lishi kerak +998XXXXXXXXX

POST /api/groups/:id/import

Excel faylidan mijozlarni ommaviy import qiling.

bash

curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -F "file=@contacts.xlsx" \
  https://api.xabarchi.live/api/groups/group-123/import

phoneNumber	name
+998901234567	John Doe

json

{
  "jobId": "import-xyz",
  "message": "Import started"
}

GET /api/groups/import/:jobId

Import jarayonini kuzating.

json

{
  "jobId": "import-xyz",
  "status": "completed",
  "totalRows": 1000,
  "importedCount": 985,
  "skippedCount": 10,
  "errorCount": 5
}

DELETE /api/groups/:id

Guruh va uning barcha mijozlarini o'chiring.

bash

curl -X DELETE \
  -H "Authorization: Bearer $TOKEN" \
  https://api.xabarchi.live/api/groups/group-123