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) талаб мекунад. Ҳар як калид иҷозатномаҳои худро (мавқеъ) ва маҳдудияти суръати худро дорад ва метавонад дар ҳар вақт бекор карда шавад.

Храните ключи на своём сервере или в настройках плагина, но никогда в публичном фронтенд-коде. ChatGetz хранит только SHA-256-хеш каждого ключа.

Маҳдудиятҳо ва нархгузорӣ

• Global Pro: дархостҳои API бемаҳдуд.
• Basic: 1 000 дархостҳо дар як моҳ (дар рӯзи 1-ум, вақти Ташкент).
• Ҳисобҳои бе нақша дастрасӣ ба API надоранд.
• Ҳар як калид маҳдудияти суръати худро дорад (10-120 дархостҳо дар дақиқа). Дар ҳолати зиёд будани лимити, API ба 429 - (Retry-After) ҷавоб медиҳад.
• Барои эҷоди матни AI мувофиқи рӯйхати нархҳои умумӣ пардохт карда мешавад: аввал аз ҳаққи моҳонаи шумо, сипас аз баланси ChatGetz.
• Заголовки Idempotency-Key-ро бо дархостҳои AI фиристед: барои такрор кардани дархости як калид ҳеҷ гоҳ ду маротиба пардохт нахоҳад шуд.

Нуқтаҳои ниҳоӣ

• get/api/v1/account/balanceНақша, баланс, иловапулии AI ва квотаи APIaccount:read
• get/api/v1/modelsНамунаҳои матнӣ ва дастрасии онҳо барои калиди шумоai:generate
• post/api/v1/ai/generateМатнро эҷод кунед; аз баланс пардохт карда мешавад (дар аввал иҷозатнома дохил шудааст)ai:generate
• get/api/v1/market/listingsШумо ChatGetz Market рӯйхатиmarket:read
• post/api/v1/market/listingsЭҷоди рӯйхати бозор (бо нобаёнӣ сиёҳнавис)market:write
• post/api/v1/ingest/eventsДархости фармоиш ё фурӯшро аз плагин (веб-хабар) қабул кунедingest:write
• get/api/v1/openapi.jsonСпецификация OpenAPI 3.1 этого API

Плагинҳо фармонҳои навро пахш мекунанд ва ба POST /api/v1/ingest/events. мераванд.

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 -ро истифода мебаранд. Ин калид дар танзимоти плагин, на дар коди худ нигоҳ дошта мешавад.