ChatGetz API for udviklere

Hurtig start

1. Log ind og åbn Dashboard → API simuleringsnøgler.
2. Opret en nøgle med de tilladelser, du har brug for og kopier den (den vises kun én gang).
3. Send det i Authorization header: 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)."
  }'

Godkendelse og områder

Hver anmodning har brug for en personlig API nøgle i Authorization: Bearer cgk_… header (eller X-API-Key). Hver nøgle har sine egne tilladelser (scope) og sats grænse og kan til enhver tid tilbagekaldes.

Hold nøgler på din server eller i plugin indstillinger, aldrig i offentlige frontend kode. ChatGetz gemmer kun et SHA-256 hash af hver nøgle.

Begrænsninger og priser

• Global Pro: ubegrænset API anmodninger.
• Basic: 1.000 anmodninger om måneden (nulstilles den 1., Tashkent tid).
• Konti uden en plan har ingen API-adgang.
• Hver nøgle har sin egen hastighedsgrænse (10-120 anmodninger pr. Over grænsen svarer API til 429 med en Retry-After header, og der sendees til at prøve igen.
• AI-tekstgenerering opkræves i henhold til den offentlige prisliste: først fra din månedlige AI-godtgørelse, derefter fra din ChatGetz saldo.
• Send en Idempotency-Key header med AI anmodninger: En gentaget anmodning med samme nøgle bliver aldrig.

Endpoints

• get/api/v1/account/balancePlan, saldo, inkl. AI-kvote og API kvoteaccount:read
• get/api/v1/modelsTekstmodeller og deres tilgængelighed for din nøgle, samt tekster der er skrevet af andreai:generate
• post/api/v1/ai/generateGenerer tekst; opkræves fra saldoen (inkluderet kvote først)ai:generate
• get/api/v1/market/listingsDine annoncer på ChatGetz Marketmarket:read
• post/api/v1/market/listingsOpret en markedsplacering (et udkast til standard)market:write
• post/api/v1/ingest/eventsModtag en ordre eller et lead fra et plugin (webhook)ingest:write
• get/api/v1/openapi.jsonOpenAPI 3.1 specifikation af denne API

Plugins sender nye ordrer og fører til POST /api/v1/ingest/events. Genafsendelse af en hændelse med samme kilde, type og externalId er sikkert: den gemmes kun én gang.

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

Fejl

Fejl er JSON med en stabil maskinlæsbar kode og engelsk besked. Byg din integration på koden.

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

Plugins

Alle plugins er open source (GPL-kompatible) og bruger din API nøgle, som du kan købe hos os. Nøglen gemmes i plugin-indstillingerne, aldrig i koden. Nøglen er ikke tilgængelig for andre plugins end dem der allerede findes på din hjemmeside.