ChatGetz API for developers

Tiz başla

1. Baglanyşyk açyň we Dashboard → API açarlaryny açyň.
2. Mugt açar dörediň we ony nusgalaň (ol diňe bir gezek görkezilýär).
3. Authorization başlygy bilen iberiň: 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)."
  }'

Tanyşdyrma we aralyklar

Her bir talap üçin Authorization: Bearer cgk_… (ýa-da X-API-Key) başlygynda şahsy API açar gerek. Her bir açaryň öz ygtyýarnamalary (çägi) we tizligi çäklendirilýär we islendik wagt ýatyrylyp bilner.

Açarlary serweriňizde ýa-da plugin sazlamalarynda saklaň, hiç haçan jemgyýetçilik front-end kodunda. ChatGetz her bir açaryň diňe SHA-256 haşyalinasyny saklaýar.

Limitler we bahalar

• Global Pro: çäksiz API islegler.
• Basic: her aý 1 000 islegler (Taşkent wagty bilen 1-nji noýabrda täzelenýär).
• Plansyz hasaplaryň API-e elýetergsi ýok.
• Her bir açaryň öz tizligi çäklendirilendir (minutda 10-120 sorag). API limitden geçýär we Retry-After başlygy bilen 429 jogap berýär.
• AI metinde döredijilik üçin tölegler döwlet bahalar sanawyna görä tölenilýär: ilki aýlyk AI paýyňyzdan, soňra bolsa ChatGetz balansyňyzdan.
• konfensiýa-alkyş başlygyny AI islegleri bilen iberiň: şol bir alkymy ulanyp tekrarlan islegiň tölegini iki gezek tölemek.

Ahyryna çenli

• get/api/v1/account/balancePlan, balans, AI kömek puly we API kvotasy hem-de beýlekileraccount:read
• get/api/v1/modelsMetin modeller we olaryň açaryňyz üçin elýeterliligiai:generate
• post/api/v1/ai/generateMetin döret; balansdan tölenilýär (öňräk goşmaça töleg)ai:generate
• get/api/v1/market/listingsSiziň ChatGetz Bazar sanawymarket:read
• post/api/v1/market/listingsBir bazar sanawyny dörediň (öň bellenen bir draft)market:write
• post/api/v1/ingest/eventsBir pluginden (webhook) bir islegi ýa-da netijäni kabul ediňingest:write
• get/api/v1/openapi.jsonСпецификация OpenAPI 3.1 этого API

Pluginler täze emri çykarýar we POST /api/v1/ingest/events.-e eltýä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

JSON hatasydyr, maşyn okap boljak kod we iňlis dilinde habar bilen. Kodyň üstünden-iňizi bina ediň.

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

Plug-inler

Bütün pluginler açyk çeşmelidir (GPL-e laýyk gelýär) we siziň API açaryňyzy ulanýar. Açar hiçyagy kodda däl, pluginiň konfigurasiýasynda saklanýar.