ChatGetz API developers

Tez başlamaq

1. Giriş edin və Dashboard → API açarlarını açın.
2. Siz lazım olan və kopyalamaq üçün bir əsas yaradın (bu, yalnız bir kez göstərilir).
3. Onu Authorization başlıqda göndərin: 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)."
  }'

Authentication and DISPS

Hər hansı Authorization-də bir şəxsi API əsas lazımdır: Bearer cgk_… başlığı (ya da X-API-Key). Hər hansı bir əsas öz məlumatları (piktorlar) və dərman limiti var və hər hansı bir vaxtda geri ola bilər.

server və ya plugin parametrlərində anahtarlar tutmaq, ictimai ön kodda heç bir zaman. ChatGetz mağazalar yalnız SHA-256 hər hansı bir əsas var.

Limitlər və qiymətləndirmə

• Global Pro: Limitsiz API məlumat
• Basic: 1st, Tashkent vaxtı üzrə 1.000 sor kaalutiyyəsi.
• Planı olmayan hesabların API-ə çıxışı yoxdur.
• Hər bir əsas öz faiz limiti var (10-120 dəqiqə) API cavabından əvvəl bir Retry- after başlığı ilə 429.
• AI məhsulunun ictimai qiymət siyahısı tərəfindən ödəniş edilir: ilk aylıq AI əməliyyatdan, sonra ChatGetz balansdan.
• AI məlumatları ilə bir Idempotency-Key başlığını göndərin: eyni əsas ilə retried istək iki dəfə heç vaxt deyil.

Son simulyasiya nöqtələri

• get/api/v1/account/balancePlan, balans, AI məlumat daxildir və API konfransaccount:read
• get/api/v1/modelsE-poçt modelləri və onların mövcudluğuai:generate
• post/api/v1/ai/generateGenrate məhsul; balansdan qəbul (ilk daxil olmaqla)ai:generate
• get/api/v1/market/listingsSizin ChatGetz Market siyahılarımarket:read
• post/api/v1/market/listingsBir Market siyahısı yaradın (öncəki olaraq bir draft)market:write
• post/api/v1/ingest/eventsBir sifariş almaq və addım (webhook)ingest:write
• get/api/v1/openapi.jsonOpenAPI 3.1 bu API spesifikasiyası

Plugins yeni sifarişlər itir və POST /api/v1/ingest/events. eyni məhsul, növü və xarici məhsulun təhlükəsizdir: yalnız bir kez saxlanılır.

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

Xətalar

Fayllar sabit maşın hazırlıq kodu və bir İngilis mesajı ilə JSON var. kodun inteqrasiyasını yaradır.

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

Plugins. Pluginlər

Bütün plugins açıq məhsuldur (GPL-compatible) və API əsas istifadə edin. Əsas plugin ayarlarında saxlanılır, kodda heç bir zaman.