ChatGetz API voor ontwikkelaars

aparten start

1. Meld u aan en open Dashboard → APIovuit.
2. Maak een sleutel aan met de machtigingen die u nodig hebt en kopieer deze (deze wordt slechts één keer weergegeven).
3. Stuur het in de header 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)."
  }'

Authenticatie en scope's

Elk verzoek heeft een persoonlijke API-sleutel nodig in de header Authorization: Bearer cgk_… (of X-API-Key). Elke sleutel heeft zijn eigen machtigingen (scopes) en snelheidslimiet en kan op elk moment worden ingetrokken.

Bewaar sleutels op uw server of in de plugin-instellingen, nooit in openbare front-endcode. ChatGetz slaat alleen een SHA-256 hash van elke sleutel op.

Limieten en prijzen

• Global Pro: onbeperkt API verzoeken.
• Basic: 1.000 verzoeken per maand (reset op de 1e, Tasjkent tijd).
• Rekeningen zonder plan hebben geen API-toegang.
• Elke sleutel heeft een eigen snelheidslimiet (10-120 verzoeken per minuut) en is afhankelijk van de gebruikteowymogelijkheden. Als de limiet is overschreden, beantwoordt API het sovranum 429 met een Retry-After header.
• AI-tekstgeneratie wordt in rekening superficieel gebracht: eerst van uw maandelijkse AI-toeslag, vervolgens van uw ChatGetz saldo.
• Stuur een Idempotency-Key header met AI verzoeken: Een herhaald verzoek met dezelfde sleutelsleutel wordt nooit tweemaal in rekening gebracht.

Endpoints

• get/api/v1/account/balancePlan, balans, inclusief AI-toeslag en API quotumaccount:read
• get/api/v1/modelsTekstmodellen en hun beschikbaarheid voor uw sleutel, tekstmodellen die u kunt gebruikenai:generate
• post/api/v1/ai/generateTekst genereren; in rekening gebracht van het saldo (inclusief toeslag eerst)ai:generate
• get/api/v1/market/listingsUw ChatGetz Market aanbiedingenmarket:read
• post/api/v1/market/listingsMaak een Market-vermelding (standaard is dit een concept)market:write
• post/api/v1/ingest/eventsOntvang een bestelling of lead vanuit een plugin (webhook) en stuur deze door naar je webshopingest:write
• get/api/v1/openapi.jsonDe OpenAPI 3.1 specificatie van deze API

Plugins pushen nieuwe orders en leiden tot POST /api/v1/ingest/events. Een gebeurtenis opnieuw verzenden met dezelfde bron, type en externalId is veilig: deze wordt slechts eenmaal opgeslagen.

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

Fouten

Fouten zijn JSON met een stabiele machineleesbare code en een Engelse foutmelding. Bouw je integratie op de code. Bouw uw integratie op het hate-code.

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

Plug-ins

Alle plugins zijn open source (GPL-compatibel) en gebruiken uw API sleutel, die u kunt downloaden van de website. De sleuyaggregaat wordt opgeslagen in de plugin-instellingen, nooit in de code.