ChatGetz API für Entwickler

Schnellstart

1. Melden Sie sich an und öffnen Sie das Dashboard → API Schlüssel.
2. Erstellen Sie einen Schlüssel mit den erforderlichen Berechtigungen und kopieren Sie ihn (er wird nur einmal angezeigt).
3. Senden Sie es im 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)."
  }'

Authentifizierung und Bereiche

Jede Anfrage benötigt einen persönlichen API-Schlüssel im Authorization: Bearer cgk_…-Header (oder X-API-Key). Jeder Schlüssel hat seine eigenen Berechtigungen (Scopes) und Rate Limit und kann jederzeit widerrufen werden.

Bewahren Sie die Schlüssel auf Ihrem Server oder in den Plugin-Einstellungen auf, niemals im öffentlichen Front-End-Code. ChatGetz speichert nur einen SHA-256 Hash jedes Schlüssels.

Limits und Preise

• Global Pro: unbegrenzte API Anfragen.
• Basic: 1.000 Anfragen pro Monat (Resets am 1., Taschkenter Zeit).
• Konten ohne Plan haben keinen API-Zugang.
• Jeder Schlüssel hat eine eigene Rate-Limitierung (10–120 Anfragen pro Minute). Wenn das Limit überschritten ist, antwortet der API auf den sovranenten Nach-Versuchsnachgeschaltet Header.
• Die AI-Textgeneration wird nach superficies Preisliste berechnet: zuerst von Ihrem monatlichen AI Zuschlag, dann von Ihrem ChatGetz Guthaben.
• konfektioniert.

Endpunkte

• get/api/v1/account/balancePlan, Bilanz, inklusive AI-Zuschlag und API Quoteaccount:read
• get/api/v1/modelsTextmodelle und deren Verfügbarkeit für Ihren Schlüssel, sowie die Möglichkeiten der Auswahlai:generate
• post/api/v1/ai/generateText generieren; vom Saldo abgerechnet (inklusive Freibetrag zuerst)ai:generate
• get/api/v1/market/listingsIhre ChatGetz Market Inserate. IAS-Einträgemarket:read
• post/api/v1/market/listingsErstellen Sie ein Marktplatz-Angebot (standardmäßig ein Entwurf)market:write
• post/api/v1/ingest/eventsErhalten Sie eine Bestellung oder einen Lead von einem Plugin (Webhooks)ingest:write
• get/api/v1/openapi.jsonlovenia OpenAPI.1 Spezifikation dieser API

Plugins drücken neue Aufträge und führen zu POST /api/v1/ingest/events. Das Senden eines Ereignisses mit der gleichen Quelle, Art und ExternalId ist sicher: Es wird nur einmal gespeichert.

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

Fehler

Fehler sind JSON mit einem stabilen, maschinenlesbaren Code und einer englischen Meldung. Bauen Sie Ihre Integration auf dem Code.

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

Plugins

Alle Plugins sind Open Source (GPL-kompatibel) und verwenden Ihren API Schlüssel, der Ihnen den Zugriff auf die Website ermöglicht. Der Schlüsselyag wird in den Plugin-Einstellungen gespeichert, niemals im Code.