ChatGetz API per gli sviluppatori

Avvio rapido

1. Accedi e apri le chiavi Dashboard → API.
2. Crea una chiave con le autorizzazioni necessarie e copiala (viene mostrata solo una volta).
3. Invialo nell'intestazione 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)."
  }'

Autenticazione e ambiti

Ogni richiesta ha bisogno di una chiave personale API nel Authorization: Bearer cgk_… intestazione (o X-API-Key). Ogni chiave ha le proprie autorizzazioni (scopi) e limite di tasso e può essere revocato in qualsiasi momento.

Mantenere i tasti sul server o nelle impostazioni del plugin, mai in codice front-end pubblico. ChatGetz memorizza solo un SHA-256 hash di ogni chiave.

Limiti e prezzi

• Global Pro: illimitate richieste API.
• Basic: 1000 richieste al mese (resets on the 1st, Tashkent time).
• I conti senza un piano non hanno accesso al API.
• Ogni chiave ha un proprio limite di velocità (10-120 richieste al minuto). Al di sopra del limite, il API risponde a 429 con un'intestazione Retry-After.
• La generazione di testi AI viene addebitata dall'elenco dei prezzi pubblici: prima dal tuo assegno mensile AI, poi dal tuo saldo ChatGetz.
• konfessione di una richiesta con la stessa chiave: non si fa mai due volte questa liputazione.

Endpoint

• get/api/v1/account/balancePiano, saldo, inclusa indennità AI e quota APIaccount:read
• get/api/v1/modelsModelli di testo e loro disponibilità per la tua chiaveai:generate
• post/api/v1/ai/generateGenerare testo; addebitato dal saldo (indennità inclusa prima)ai:generate
• get/api/v1/market/listingsI tuoi ChatGetz Market listingsmarket:read
• post/api/v1/market/listingsCrea un'inserzione di mercato (una bozza per impostazione predefinita)market:write
• post/api/v1/ingest/eventsRicevere un ordine o una lead da un plugin (webhook)ingest:write
• get/api/v1/openapi.jsonLe OpenAPI 3.1 specifiche di questo API

I plugin inviano nuovi ordini e portano a POST /api/v1/ingest/events. Il rinvio di un evento con la stessa origine, tipo ed externalId è sicuro: viene memorizzato solo una volta.

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

Errori

Gli errori sono JSON con un codice stabile leggibile da una macchina e un messaggio in inglese. Costruisci la tua integrazione sul codice.

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

Plugin

Tutti i plugin sono open source (compatibile con la GPL) e utilizzano il tuo codice API. La chiave è memorizzata nelle impostazioni del plugin, mai nel codice; la chiave viene salvata solo quando il plugin si avvia.