Dasturchilar uchun ChatGetz API

Tez boshlash

1. Tizimga kiring va Dashboard → API kalitlar bo'limini oching.
2. Kerakli ruxsatlar bilan kalit yarating va uni nusxalang (faqat bir marta ko'rsatiladi).
3. Uni Authorization sarlavhasida yuboring: Bearer cgk_…

curl https://www.chatgetz.uz/api/v1/account/balance \
  -H "Authorization: Bearer $CHATGETZ_API_KEY"

curl https://www.chatgetz.uz/api/v1/ai/generate \
  -H "Authorization: Bearer $CHATGETZ_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 5f0c6f5e-order-42" \
  -d '{
    "model": "deepseek/deepseek-v4-flash",
    "prompt": "Write a 60-word description for a cotton kids hoodie",
    "instructions": "Answer in Uzbek (Latin script)."
  }'

Autentifikatsiya va ruxsatlar

Har bir so'rovda Authorization: Bearer cgk_… (yoki X-API-Key) sarlavhasida shaxsiy API kalit bo'lishi kerak. Har bir kalitning o'z ruxsatlari (scopes) va so'rovlar limiti bor, uni istalgan vaqtda bekor qilish mumkin.

Kalitlarni serveringizda yoki plagin sozlamalarida saqlang, hech qachon ochiq front-end kodida emas. ChatGetz har bir kalitning faqat SHA-256 xeshini saqlaydi.

Limitlar va narxlar

• Global Pro: cheksiz API so'rovlari.
• Basic: oyiga 1 000 ta so'rov (har oyning 1-sanasida, Toshkent vaqti bilan yangilanadi).
• Tarif tanlanmagan hisoblar uchun API yopiq.
• Har bir kalitning o'z limiti bor (daqiqasiga 10–120 so'rov). Limitdan oshsa, API Retry-After sarlavhasi bilan 429 javobini qaytaradi.
• AI matn yaratish ochiq narxlar jadvali bo'yicha avval oylik AI limitingizdan, keyin ChatGetz balansingizdan yechiladi.
• AI so'rovlarida Idempotency-Key sarlavhasini yuboring: xuddi shu kalit bilan qayta yuborilgan so'rov uchun ikki marta pul yechilmaydi.

Endpointlar

• get/api/v1/account/balanceReja, balans, kiritilgan AI limiti va API kvotasiaccount:read
• get/api/v1/modelsMatn modellari va ularning kalitingiz uchun mavjudligiai:generate
• post/api/v1/ai/generateMatn yaratish; balansdan yechiladi (avval kiritilgan limitdan)ai:generate
• get/api/v1/market/listingsChatGetz Market'dagi e'lonlaringizmarket:read
• post/api/v1/market/listingsMarket e'lonini yaratish (standart holatda qoralama)market:write
• post/api/v1/ingest/eventsPlagindan buyurtma yoki lid qabul qilish (webhook)ingest:write
• get/api/v1/openapi.jsonUshbu API'ning OpenAPI 3.1 spetsifikatsiyasi

Plaginlar yangi buyurtma va lidlarni POST /api/v1/ingest/events manziliga yuboradi. Xuddi shu source, type va externalId bilan hodisani qayta yuborish xavfsiz: u faqat bir marta saqlanadi.

curl https://www.chatgetz.uz/api/v1/ingest/events \
  -H "Authorization: Bearer $CHATGETZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "order", "source": "woocommerce", "externalId": "1042",
    "customer": { "name": "Aziza", "phone": "+998901234567" },
    "total": { "amount": "249000", "currency": "UZS" },
    "items": [{ "name": "Hoodie", "quantity": 1, "price": "249000" }]
  }'

Xatolar

Xatolar JSON ko'rinishida: barqaror mashina o'qiydigan kod va inglizcha xabar. Integratsiyangizni kodga tayanib quring.

{
  "error": {
    "code": "quota_exceeded",
    "message": "Monthly Basic API quota exhausted. ..."
  }
}

Plaginlar

Barcha plaginlar ochiq kodli (GPL bilan mos) va API kalitingizdan foydalanadi. Kalit kodda emas, plagin sozlamalarida saqlanadi.