Geliştiriciler için ChatGetz API

Hızlı başla

1. Giriş yapın ve Dashboard → API simulasyonunu açın.
2. İhtiyaç duyduğunuz izinlerle bir anahtar oluşturun ve kopyalayın (sadece bir kez gösterilir).
3. Authorization başlığında gönderin: 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)."
  }'

Kimlik doğrulaması ve kapsamlar

Her istek Authorization'de kişisel API anahtara ihtiyaç duyar: Bearer cgk_… başlık (veya X-API-Key). Her anahtarın kendi izni vardır (gazeteler) ve oranı sınırı vardır ve herhangi bir zamanda iptal edilebilir.

Sunucunuzda veya eklenti ayarlarında anahtar tutun, asla halka açık ön kodda değil. ChatGetz Mağazalar sadece SHA-256 her anahtarın yanındadır.

Limitler ve fiyatlandırma

• Global Pro: sınırsız API talep.
• Basic: ayda 1.000 talep (1st, Tashkent zamanında)
• Plansız hesapların API erişimi yoktur.
• Her anahtarın kendi oranı sınırı vardır (10-120 dakika içinde istekler). API'in 429'u bir Retry- Afterhead ile sınırlıyor.
• AI metin üretimi kamu fiyat listesine göre ücretlendirilir: önce aylık AI ödeneğiniz, sonra da ChatGetz hesabınızdan.
• AI talepleriyle birlikte simulpotensy-key başlığı gönder: aynı anahtarla tekrar deneme talebi asla iki kez faturalandırılmaz.

Son noktalar

• get/api/v1/account/balancePlan, denge, AI ödeneği ve API kotası dahilaccount:read
• get/api/v1/modelsMetin modelleri ve anahtarınız için mevcut olmalarıai:generate
• post/api/v1/ai/generateMetin oluştur; bilançodan tahsil edilir (öncelikle ödenek dahil)ai:generate
• get/api/v1/market/listingsChatGetz Market listelerinizmarket:read
• post/api/v1/market/listingsBir Pazar listesi oluşturun (varsayılan olarak bir taslak)market:write
• post/api/v1/ingest/eventsBir sipariş alın veya bir eklentiden (webhook) liderlik ediningest:write
• get/api/v1/openapi.jsonOpenAPI 3.1 bu API

Pluginler yeni emirleri iterek POST'a yol açar /api/v1/ingest/events. Aynı kaynak, tür ve externalId ile bir olayı tekrar göndermek güvenlidir: sadece bir kez depolanı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" }]
  }'

Hatalar

Hatalar JSON ile sabit makine okunuşu kodu ve İngilizce bir mesajdır. Entegrasyonunuzu kod üzerine inşa edin.

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

Senapa digo komponedeni

Tüm eklentiler açık kaynaklı (GPL uyumlu) ve sizin API anahtarınızı kullanır. Anahtar, hiçbir zaman kodta değil eklenti ayarlarında depolanır.