ChatGetz API для распрацоўшчыкаў

Хуткі старт

1. Увайдзіце ў сістэму і адкрыйце панель прыладаў → 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)."
  }'

Аўтэнтыфікацыя і аб'ёмы

Кожны запыт патрабуе персанальнага ключа API у загалоўку Authorization: Bearer cgk_… (або X-API-Key). Кожны ключ мае свае правы доступу (аб'ём) і абмежаванне хуткасці і можа быць адменены ў любы час.

Трымайце ключы на сваім серверы або ў наладах, ніколі не ў публічным фронтэнд-кодзе. ChatGetz захоўвае толькі SHA-256 хэш кожнага ключа.

Лімыты і цэны

• Global Pro: неабмежаваная колькасць запытаў API.
• Basic: 1000 запытаў на месяц (счытваецца 1-га па ташкентскім часе).
• Скончаны рахункі без плана не маюць доступу да API.
• Кожны ключ мае сваё абмежаванне хуткасці (10-120 запытаў у хвіліну). Калі перавышаецца абмежаванне, API адказвае 429 з загалоўкам Retry-After.
• Генерацыя тэксту AI аплачваецца па публічным тарыфныме: спачатку з вашага штомесячнага даходу AI, затым з ChatGetz.
• -Key загалоўка з AI просіць: паўторная спроба запыту з тым жа ку не ставіцца ніколі два разы.

Канечныя пункты

• get/api/v1/account/balanceПлан, баланс, уключаючы надбаўку па інваліднасці і квоту APIaccount: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.jsonСпецификация OpenAPI 3.1 этого API

Плагіны адпраўляюць нты і прыводзяць да POST /api/v1/ingest/events. Перадрук падзеі з тым жа крыніцай,пам externalId безопасен: яна захоўваецца толькі адзін раз.

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. Ключ захваецца ў наладаках плагіна, а не ў кодзе.