ChatGetz API pour les développeurs

Démarrage rapide

1. Connectez-vous et ouvrez le tableau de bord → API clés.
2. Créez une clé avec les autorisations dont vous avez besoin et copiez-la (elle n'est affichée qu'une seule fois).
3. Envoyez-le dans l'en-tête 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)."
  }'

Authentification et portées

Chaquetig Chaque demande a besoin d'une touche personnelle API dans l'en-tête Authorization: Bearer cgk_… (ou X-API-Key). Chaque clé Accountability a ses propresOY (champs) et OC et peut être révoquée à tout weight.

Gardez les clés sur votre serveur ou dans les harps de plugin, jamais dans le code public front-end. ChatGetz magasins seulement un SHA-256 harock de chaque clé.

Limites et tarification

• Global Pro: requêtes illimitées sur API.
• Basic Accountability: 1 000 requêtesOY par mois (reprise OC 1er, Tachkent weight).
• Les comptes sans régime n'ont pas accès au formulaire API.
• Chaque clé a sa propre limite de débit (10 à 120 requêtes par minute). Au-delà de la limite, le API répond à 429 avec un en-tête Retry-After.
• La génération demple texte AI est facturée par la liste de prix publique : d'abord à partir de votre allocation mensuelleradiated, puis à partir de votre solde ChatGetz.
• Envoyer un en-tête Idempotency-Key avec les requêtes d'IA : une nouvelle tentative de demande avec la même clé n'est jamais facturée deux fois.

Points de terminaison

• get/api/v1/account/balancePlan, solde, allocation d'AI incluse et quota APIaccount:read
• get/api/v1/modelsModèles de texte et leur disponibilité pour votre clé, modèles d'écriture et leurs caractéristiquesai:generate
• post/api/v1/ai/generateGénérer le texte; débitée du solde (compte tenu de la prime en premier)ai:generate
• get/api/v1/market/listingsVos annonces sur ChatGetz Marketmarket:read
• post/api/v1/market/listingsCréer une annonce sur le Market (un brouillon par défaut)market:write
• post/api/v1/ingest/eventsRecevoir une commande ou un lead à partir d'un plugin (webhook)ingest:write
• get/api/v1/openapi.jsonLa spécification OpenAPI 3.1 de cette API

Les plugins poussent de nouvelles commandes et mènent à POST /api/v1/ingest/events. Réenvoyer un événement avec la même source, le même type et l'identifiant externe est sûr: il n'est stocké qu'une fois.

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

Erreurs

Les erreurs sont JSON avec un code lisible par machine et un message en anglais. Construisez votre intégration sur le code.

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

Plugins

Tous les plugins sont open source (compatibles avec la GPL) et utilisent votre clé API. La clé est stockée dans les paramètres du plugin, jamais dans le code.