ChatGetz API vir ontwikkelaars

Vinnige begin

1. Meld aan en open Dashboard importante → API.
2. Skep 'n sleutel met die regte wat jy nodig het en kopieer dit (dit word net een keer getoon).
3. Stuur dit in die Authorization kop: 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)."
  }'

Geld tsiming entúre

Every request needs a personal API key in the Authorization: Bearer cgk_… header (or X-API-Key). Each key has its own permissions (scopes) and rate limit and can be revoked at any time.

Hou sleutels op jou server of in die inpropinstellings, nooit in die publieke voor-end kode. ChatGetz stoor slegs 'n SHA-256 hash van elke sleutel.

Limiete en pryse

• Global Pro: onbeperkte API versoeke.
• Tot van die Basic: 1 000 versoeke per maand (op die khoz Ôha, die 1 van die 1 van tona in die 1？
• Rekeninge sonder 'n plan het geen API toegang nie.
• Elke sleutel het sy eie snelheidsbeperking (10–120 versoeke per minuut). Bo die limiet antwoord API op 429 met 'n Herprobeer-Na kop.
• AI-teksgenerasie word in rekening gebring volgens die openbare pryslys: eers van u maandlikse AI-toelaag, dan van u ChatGetz-balans.
• Stuur 'n Idempotency-Key-kop met AI-aanvrae: 'n herproefde aanvraag met dieselfde sleutel word nooit twee keer in rekening gebring nie.

Eindepunte

• get/api/v1/account/balancePlan, balans, insluitend AI-toelaag en API kwotaaccount:read
• get/api/v1/modelsTeksmodelle en hul beskikbaarheid vir jou sleutelai:generate
• post/api/v1/ai/generateGenereer teks; in rekening gebring van die balans (insluitende toelaag eerste)ai:generate
• get/api/v1/market/listingsJou ChatGetz Market-verwysingsmarket:read
• post/api/v1/market/listingsSkep 'n markvermelding ('n opstel by verstek)market:write
• post/api/v1/ingest/eventsOntvang 'n bestelling of lei van 'n inprop (webhook)ingest:write
• get/api/v1/openapi.jsonDie OpenAPI 3.1 spesifikasie van hierdie API

Inpropmodules dwing nuwe bestellings en lei na POST /api/v1/ingest/events. Herrompeling van 'n gebeurtenisு met dieselfde bron, tipe en olupinID is vei: dit word net een keer gestoor. Tune-Upenmaanisem

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

Foute

Foute is JSON met 'n stabiele masjienleesbare kode en 'n Engelse boodskap. Bou jou integrasie op die kode.

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

Inproppe

Alle inpropmodules is oopbron (GPL-kompatibel) en gebruik jou API-sleutel. Die sleutel word gestoor in die inpropinstellings, nooit in die kode nie.