ChatGetz API för utvecklare

Snabbstart

1. Logga in och öppna Dashboard → API nycklar.
2. Skapa en nyckel med de behörigheter du behöver och kopiera den (den visas bara en gång).
3. Skicka den i Authorization-rubriken: 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)."
  }'

Autentisering och omfattningar

Varje begäran behöver en personlig API-nyckel i Authorization: Bearer cgk_…-rubriken (eller X-API-Key). Varje nyckel har sina egna behörigheter (skop) och räntebegränsning och kan återkallas när som helst.

Håll nycklar på din server eller i plugin-inställningar, aldrig i offentlig front-end-kod. ChatGetz lagrar endast en SHA-256 hash av varje nyckel.

Gränser och priser

• Global Pro: obegränsat antal API-förfrågningar.
• Basic: 1 000 förfrågningar per månad (återställs på 1: a, Tashkent tid).
• Konton utan en plan har ingen API-åtkomst.
• Varje nyckel har sin egen räntegräns (10–120 förfrågningar per minut). Över gränsen svarar API 429 med en Retry-After-rubrik.
• olär textgenerering debiteras enligt den offentliga prislistan: först från din månatliga AI-tillägg, sedan från ditt ChatGetz saldo.
• Skicka en Idempotency-Key-adress med förfrågningar från AI:n.

Slutpunkter

• get/api/v1/account/balancePlan, balans, inklusive AI-ersättning och API kvotaccount:read
• get/api/v1/modelsTextmodeller och deras tillgänglighet för din nyckel, samt texter som är särskilt anpassade för digai:generate
• post/api/v1/ai/generateGenerera text; debiteras från saldot (inklusive kvot först)ai:generate
• get/api/v1/market/listingsDina annonser på ChatGetz Marketmarket:read
• post/api/v1/market/listingsSkapa en marknadsplats (en utkast för icke-medborgare)market:write
• post/api/v1/ingest/eventsTa emot en beställning eller lead från ett plugin (webhook)ingest:write
• get/api/v1/openapi.jsonOpenAPI 3.1 specifikationen för denna API

/api/v1/ingest/events. Att skicka en händelse med samma källa, typ och externalId på nytt är säkert: den lagras bara en gång.

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

Fel

Felkoden är JSON med en stabil maskinläsbar kod och ett engelskt felmeddelande. Bygg din integration på koden.

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

Insticksprogram

Alla plugins är öppen källkod (GPL-kompatibla) och använder din API nyckel. Nyckeln lagras i plugin-inställningarna, aldrig i koden. Nyckeln är en del av insticksmodulen och används för att aktivera eller inaktivera den.