ڈیولپروں کے لئے 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)."
  }'

توثیق اور دائرہ عمل

ہر درخواست کو Authorization: Bearer cgk_… ہیڈر (یا X-API-Key) میں ایک ذاتی API کی ضرورت ہے۔ ہر کلید کی اپنی اجازتیں (اسکوپ) اور شرح حد ہے اور اسے کسی بھی وقت میں منسوخ کیا جا سکتا ہے۔

اپنی سرور پر یا پلگ ان کی ترتیبات میں کلیدوں کو محفوظ رکھو، کبھی بھی عوامی فرینٹ-اینڈ کوڈ میں نہیں۔ ChatGetz ہر کلید کا صرف ایک SHA-256 ہش محفوظ کرتا ہے۔

حدیں اور قیمتیں

• Global Pro: لامحدود API درخواستیں۔
• Basicء: 1,000 درخواستیںء ہر ماہ ( یکمء، تاش ناراست وقت پر)۔
• پلان کے بغیر اکاؤنٹس کو API تک رسائی نہیں ہوتی ہے۔
• ہر کلید اپنی شرح حدیث (10–120 استدلالات فی منٹ) رکھتا ہے۔ حدیثِ حدیث APIءمیں مطمئن ہو کر 429 جواب دیتا ہے جس میں ایک ریاضی کے بعد سر انجام دیے جاتے ہیں۔
• ی ٹیکٹج کی پیداوار کو عوامی قیمت کے لسٹ سے چارج کیا جاتا ہے: پہلے آپ کے ماہانہ ای آئی رلیشن سے، پھر آپ کے ChatGetz بلنڈ سے۔
• اے آئی اے کی درخواستوں کے ساتھ ایک 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/listingsYour ChatGetz Market listingsmarket: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. ..."
  }
}

پلگ ان

تمام پلگ ان اوپن سورس (جی پی ایل-مطابق) ہیں اور آپ کی API کلید کا استعمال کرتے ہیں۔ کلید کوڈ میں نہیں بلکہ پلگ ان کی ترتیبات میں محفوظ کیا جاتا ہے۔