ChatGetz API untuk pembangun

Mulakan dengan cepat

1. Log masuk dan buka Dashboard → API kekunci.
2. Cipta kunci dengan keizinan yang anda perlukan dan salinkannya (ia hanya dipaparkan sekali).
3. Hantarkannya dalam pengepala 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)."
  }'

Pengesahan dan skop

Setiap permintaan memerlukan kunci peribadi API dalam pengepala Authorization: Bearer cgk_… (atau X-API-Key). Setiap kekunci mempunyai keizinan (skop) dan had kadar sendiri dan boleh dibatalkan pada bila-bila masa.

Kunci pada server ataulent Archivesana, tidakyon shopping di publiciri Wikisource Dan toko ChatGetz plantgraf hanya SHA-256 haRumah setiap kunciten.

Had dan harga

• Global Pro: Permintaan API tak terbatas.
• Basic: 1,000 permintaan per bulan (dimulakan pada 1, waktu Tashkent).
• Akaun tanpa rancangan tidak mempunyai akses ke API.
• Setiap kekunci mempunyai had kadar sendiri (10–120 permintaan per minit). Di atas had, API menjawab 429 dengan pengepala Cuba Seterusnya.
• Penjanaan teks AI dikenakan bayaran mengikut senarai harga awam: pertama dari elaun bulanan anda untuk AI, kemudian daripada baki ChatGetz anda.
• Hantar pengepala Idempotency-Key dengan permintaan AI: percubaan semula permintaan dengan kunci yang sama tidak pernah dikenakan dua kali.

Titik hujung

• get/api/v1/account/balanceRancangan, keseimbangan, termasuk elaun AI dan kuota APIaccount:read
• get/api/v1/modelsModel teks dan ketersediaan mereka untuk kekunci andaai:generate
• post/api/v1/ai/generateJanakan teks; dicaj dari baki (termasuk elaun pertama)ai:generate
• get/api/v1/market/listingsSenarai ChatGetz Market andamarket:read
• post/api/v1/market/listingsCipta senarai Pasaran (draf secara lalai)market:write
• post/api/v1/ingest/eventsTerima pesanan atau lead dari plugin (webhook)ingest:write
• get/api/v1/openapi.jsonSpesifikasi OpenAPI 3.1 ini adalah API

Plugin memaksa arahan baru dan membawa kepada POST /api/v1/ingest/events. Mengirim semula peristiwa dengan sumber, jenis dan externalId yang sama adalah selamat: ia kolu disimpan sekali sahaja.

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

Ralat

Ralat adalah JSON dengan kod yang boleh dibaca mesin dan mesej dalam bahasa Inggeris. Bina integrasi anda pada kod.

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

Plugin

Semua pemalam adalah sumber terbuka (sesuai dengan GPL) dan menggunakan kekunci API anda. Kunci disiyagkan dalam tetapan plugin, tidak pernah di kod.