ChatGetz API pro vývojáře

Rychlý start

1. Přihlaste se a otevřete Dashboard → API klíče.
2. Vytvořte klíč s oprávněními, které potřebujete a zkopírujte ho (je zobrazen pouze jednou).
3. Pošlete ji v záhlaví 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)."
  }'

Ověřování a obory

Každý požadavek potřebuje osobní API klíč v záhlaví Authorization: Bearer cgk_… (nebo X-API-Key). Každý klíč má svá vlastní oprávnění (dalekohledy) a limit sazeb a může být kdykoliv zrušen.

Mějte klíče na serveru nebo v nastavení plugin, nikdy na veřejnosti front- end kód. ChatGetz ukládá jen SHA-256 hash každého klíče.

Limity a ceny

• Global Pro: neomezený počet požadavků API.
• Basic: 1 000 požadavků za měsíc (resets on the 1st, Taškent time).
• Účty bez plánu nemají přístup k API.
• Každý klíč má svůj vlastní limit rychlosti (10–120 požadavků za minutu). Při překročení limitu odpovídá API na číslo 429 s hlavičkou Retry-After.
• Generování textu AI se účtuje podle veřejného ceníku: nejprve z měsíčního příspěvku na AI, poté ze zůstatku ChatGetz.
• Odeslat hlavičku Idempotency-Key s požadavky AI: opakovaný pokus o žádost se stejným klíčem není nikdy účtován dvakrát.

Koncové body

• get/api/v1/account/balancePlán, zůstatek, včetně příspěvku na AI a kvóty APIaccount:read
• get/api/v1/modelsTextové modely a jejich dostupnost pro váš klíč. Textový model je určen pouze pro psaní textů na klávesniciai:generate
• post/api/v1/ai/generateVygenerovat text; účtováno ze zůstatku (nejprve zahrnutý příspěvek)ai:generate
• get/api/v1/market/listingsVaše inzeráty na ChatGetz Marketmarket:read
• post/api/v1/market/listingsVytvořte nabídku na trhu (standardně se jedná o návrh)market:write
• post/api/v1/ingest/eventsPřijímání objednávek nebo potenciálních zákazníků z pluginu (webhook)ingest:write
• get/api/v1/openapi.jsonSpecifikace OpenAPI 3.1 této specifikace API

Pluginy odesílají nové příkazy a vedou k POST /api/v1/ingest/events. Opakované odeslání události se stejným zdrojem, typem a externalId je bezpečné: ukládá se pouze jednou.

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

Chyby

Chyby jsou JSON se stabilním strojově čitelným kódem a anglickou zprávou. Vytvořte si integraci na základě kódu.

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

Pluginy

Všechny pluginy jsou open source (kompatibilní s GPL) a používají váš API klíč. Klíč je uložen v nastavení pluginu, nikdy ne v kódu.