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)."
  }'

Аутентификация һәм гамәлләр

Һәрбер сорау өчен Authorization: Bearer cgk_… (яки X-API-Key) башлыкларында шәхси API ачкыч кирәк. Һәрбер клавишның үзенең рөхсәтләре (ширәге) һәм тизлек чикләүләре бар һәм теләсә кайсы вакытта кире кагылырга мөмкин.

Храните ключи на своём сервере или в настройках плагина, но никогда в публичном фронтенд-коде. ChatGetz хранит только SHA-256-хеш каждого ключа.

Лимитлар һәм бәяләр

• Global Pro: чиксез API сорау.
• Basic: ай саен 1 000 сорау (Ташкент вакыты буенча 1-нче көнне).
• Плансыз исәп-хисапларның API номерына керү мөмкинлеге юк.
• Һәрбер клавишның үз тизлек чикләүләре бар (минутда 10-120 сорау). Бу чиктән тыш API җавап бирә Retry-After башлыгы белән 429.
• ИТ-текстлар төзү өчен түләү бәяләр исемлеге буенчаелә: башта сезнең айлык ИТ-килешүегездән, аннан соң сезнеңChatGetz балансыгыздан.
• AI сорауларына 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.jsonСпецификация OpenAPI 3.1 этого API

Плагиннар яңа боерыкларны куя һәм 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 ыгызны куллана. Ключ плагин параметрларында саклана, кодта беркайчан да юк.