ChatGetz API иштеп чыгуучулар үчүн

Жылдам старт

1. Dashboard → API ачкычтарын белгилеп, ачыңыз.
2. Сизге керектүү уруксаттарды камтыган ачкыч түзүп, аны көчүрүп алыңыз (ал бир жолу гана көрсөтүлөт).
3. Аны 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)."
  }'

Аутентификациялоо жана чөйрөлөр

Ар бир суроого Authorization: Bearer cgk_… (же X-API-Key) баштыкта жеке API баскычы керек. Ар бир ключдин өзүнүн авторотгону (объектиси) жана ылдамдык чектөөсү бар, ар бири каалаган убакта жокко чыгарылат.

Ачкычтарды серверде же плагин орнотууларында сактаңыз, эч качан коомдук алдыңкы коддо эмес. ChatGetz ар бир ачкычтын SHA-256 хэшин гана сактайт.

Лимиттер жана баалар

• Global Pro: чексиз API суроолор.
• Basic: айына 1 000 суроо (ташкент убактысы боюнча резеттер).
• Плансыз эсептер APIге кирүү мүмкүнчүлүгү жок.
• Ар бир клавишанын өз ылдамдыгы бар (10-120н/мин). Чектен ашып кеткенде, API Retry-After за менен 429го жооп берет.
• AI текстин түзүү үчүн акы коом тарифтик план боюнча алынат: алгач айлык AI төлөмүңүздөн, андан кийин ChatGetz балансыңыздан.
• ИИнин өтүнүчтөрү менен Idempotency-Key баштыкты жөнөтүңүз: бирдей ачкыч менен кайра иштетилген өтүнүч эч качан эки жолу алынбайт.

Конечный пункт

• get/api/v1/account/balanceПлан, баланс, ИДП жана API квотагондорго кошумча төлөмдөрaccount:read
• get/api/v1/modelsТексттик моделдер жана алардын сиздин ачкычыңызга жеткиликтүүлүгүai:generate
• post/api/v1/ai/generateТекстти түзүү; баланстан төлөнөт (алдын ала кошумча акы кошулду)ai:generate
• get/api/v1/market/listingsСиздин ChatGetz Market тизмесиmarket:read
• post/api/v1/market/listingsБиржалык тизмени түзүү (адатта черновик)market:write
• post/api/v1/ingest/eventsПлагинден (веб-сайттан) буйрутма же мүмкүнчүлүктү алууingest:write
• get/api/v1/openapi.jsonOpenAPI 3.1 бул API

Plugins жаңы буйрутмаларды түртөт жана POST /api/v1/ingest/events.ге алып келет Бир эле булак, тип жана тышкы менен окуяны жөнөтүү коопсуз: ал бир гана жолу сакталат.

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

Ката

Ката JSON, ал стабилдүү машина окуй турган код жана англис тилиндеги билдирүү менен жазылат. Сөзсүз кодду интеграциялоону түзүңүз.

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

Плагиндер

Бардык плагиндер ачык булактуу (GPL-совместимые) жана сиздин API ачкычыңызды колдонот. Бул сыр сөз куралдын параметрлеринде сакталып турат, эч качан коддо.