ChatGetz API د پرمختیا کونکو لپاره

چټک پیل

1. Sign in and open Dashboard → API keys.
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)."
  }'

هویت او ساحې

هر غوښتنلیک په Authorization کې د شخصي API کلید ته اړتیا لري: Bearer cgk_… سرلیک (یا X-API-Key). هرې کیلې خپل مجوزونه (شموله) او د نرخ حد لري او په هر وخت کې لغوه کیدی شي.

په خپل سرور کې یا د پلگ ان تنظیماتو کې کیلي وساتئ، هیڅکله په عامه مخکینۍ پای کود کې. ChatGetz یوازې د هرې کیلي SHA-256 هش ذخیره کوي.

محدودیتونه او قیمتونه

• Global Pro: نامحدود API غوښتنې.
• Basic: په میاشت کې ۱٬۰۰۰ غوښتنې (د تاشکند په وخت کې د 1st تازه کول).
• د سنگین حسابونه پرته له پلان څخه هیڅ API لاسرسی نلري.
• هره کلیدي د خپل نرخ حد لري (په دقیقو کې 10-120 غوښتنې). د حد څخه پورته API د بیا هڅې وروسته سرلیک سره 429 ځوابوي.
• AI متن جوړونه د عامه نرخ لیست لخوا لګول کیږي: لومړی ستاسو له میاشتني AI اجازه څخه، بیا ستاسو له ChatGetz تعادل څخه.
• د AI غوښتنو سره یو Idempotency-Key سرلیک واستوئ: د ورته کیلي سره بیا هڅه شوې غوښتنه هیڅکله دوه ځل نه ده.

پای ټکي

• get/api/v1/account/balanceپلان، توازن، د AI مرستې او API برخه شامله وهaccount:read
• get/api/v1/modelsد متن ماډلونه او ستاسو د کیلي لپاره د دوی شتونai:generate
• post/api/v1/ai/generateمتن رامینځته کړئ؛ د توازن څخه چارج شوی (په لومړي سر کې شامل شوي)ai:generate
• get/api/v1/market/listingsستاسو د ChatGetz بازار لیستونهmarket:read
• post/api/v1/market/listingsد بازار لست جوړ کړئ (له تل څخه یو مسوده)market:write
• post/api/v1/ingest/eventsد پلگ ان څخه امر یا لارښود ترلاسه کړئingest:write
• get/api/v1/openapi.jsonThe OpenAPI 3.1 specification of this 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 کلیدي کاروي. کیلي د پلگ ان په ترتیباتو کې ذخیره کیږي، هیڅکله نه په کوډ کې.