ChatGetz API для розробників

Швидкий старт

1. Увійдіть і відкрийте Панель → API-ключі.
2. Створіть ключ із потрібними правами та скопіюйте його (він показується лише один раз).
3. Передавайте його в заголовку 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)."
  }'

Автентифікація та права

Кожен запит має містити особистий API-ключ у заголовку Authorization: Bearer cgk_… (або X-API-Key). Кожен ключ має власні права (scopes) і ліміт запитів; його можна відкликати будь-коли.

Зберігайте ключі на своєму сервері або в налаштуваннях плагіна, але ніколи в публічному фронтенд-коді. ChatGetz зберігає лише SHA-256-хеш кожного ключа.

Ліміти та ціни

• Global Pro: безлімітні запити до API.
• Basic: 1 000 запитів на місяць (скидання 1-го числа за ташкентським часом).
• Без тарифу API недоступний.
• Кожен ключ має власний ліміт (10–120 запитів на хвилину). У разі перевищення API відповідає 429 із заголовком Retry-After.
• Генерація тексту AI списується за відкритим прайсом: спочатку з місячного AI-ліміту, потім з балансу ChatGetz.
• Передавайте заголовок Idempotency-Key у ШІ-запитах: повторний запит із тим самим ключем ніколи не буде списано двічі.

Ендпоінти

• get/api/v1/account/balanceТариф, баланс, включений ШІ-ліміт і квота APIaccount:read
• get/api/v1/modelsТекстові моделі та їх доступність для вашого ключаai:generate
• post/api/v1/ai/generateГенерування тексту; списується з балансу (спочатку з включеного ліміту)ai:generate
• get/api/v1/market/listingsВаші оголошення в ChatGetz Marketmarket:read
• post/api/v1/market/listingsСтворити оголошення в Market (за замовчуванням чернетка)market:write
• post/api/v1/ingest/eventsПрийом замовлення або ліда з плагіна (вебхук)ingest:write
• get/api/v1/openapi.jsonСпецифікація OpenAPI 3.1 цього API

Плагіни надсилають нові замовлення та ліди на POST /api/v1/ingest/events. Повторне надсилання події з тими самими source, type і externalId безпечне: вона зберігається один раз.

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

Помилки

Помилки повертаються в JSON зі стабільним машинозчитуваним кодом і повідомленням англійською. Будуйте інтеграцію на коді.

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

Плагіни

Усі плагіни мають відкритий код (сумісні з GPL) і використовують ваш API-ключ. Ключ зберігається в налаштуваннях плагіна, а не в коді.