ChatGetz API kwa watengenezaji

Kuanza kwa haraka

1. Kuingia na kufungua Dashboard → API nywila.
2. Na mcheni aliye kuumbeni nyinyi na vizazi vilivyo tangulia.
3. Tumia kichwa cha habari Authorization: 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)."
  }'

Utambulisho na vipimo

Kila ombi linahitaji ufunguo wa kibinafsi wa API katika kichwa cha Authorization: Bearer cgk_… (au X-API-Key). Kila moja ina ruhusa yake mwenyewe (scopes) na kikomo cha kiwango na inaweza kufutwa wakati wowote.

Weka funguo kwenye seva yako au katika mipangilio ya Plugin, kamwe katika msimbo wa mbele wa mwisho wa umma. ChatGetz maduka tu SHA-256 hash ya kila ufunguo.

Mipaka na bei

• Global Pro: maombi yasiyo na ukomo ya API.
• Basic: 1,000 maombi kwa mwezi (resets juu ya 1st, Tashkent wakati).
• Akaunti zisizo na mpango hazina ufikiaji wa API.
• Kila ufunguo una kikomo chake cha kiwango (maombi ya 120 kwa dakika). Juu ya kikomo API majibu 429 na Retry-Baada ya kichwa.
• Kizazi cha maandishi cha AI kinashtakiwa na orodha ya bei ya umma: kwanza kutoka kwa mshahara wako wa kila mwezi wa AI, kisha kutoka kwa usawa wako wa ChatGetz.
• Tumia kichwa cha Idempotency-Key na maombi ya AI: ombi la kujaribu tena kwa ufunguo huo kamwe halitozwa mara mbili.

Vipengele vya mwisho

• get/api/v1/account/balanceMpango, usawa ni pamoja na posho ya AI na upendeleo wa APIaccount:read
• get/api/v1/modelsMifano ya maandishi na upatikanaji wao kwa ufunguo wakoai:generate
• post/api/v1/ai/generateNakala ya Generate; kushtakiwa kutoka usawa (pamoja na posho ya kwanza)ai:generate
• get/api/v1/market/listingsOrodha yako ya ChatGetz Marketmarket:read
• post/api/v1/market/listingsKujenga orodha ya soko (drafti kwa default)market:write
• post/api/v1/ingest/eventsKupata amri au kuongoza kutoka kwa Plugin (webhook)ingest:write
• get/api/v1/openapi.jsonOpenAPI 3.1 specification ya hii API

Plugins kushinikiza amri mpya na inaongoza kwa POST /api/v1/ingest/events. Resending tukio na chanzo hicho, aina na nje ni salama: ni kuhifadhiwa mara moja tu.

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

Makosa

Makosa ni JSON na msimbo wa kusoma mashine na ujumbe wa Kiingereza. Kujenga ushirikiano wako juu ya kanuni.

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

Plugins

Plugins zote ni chanzo wazi (GPL-sawa) na kutumia ufunguo wako wa API. Muhimu ni kuhifadhiwa katika mipangilio ya Plugin, kamwe katika msimbo.