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:१,००० विनंती प्रतिमहिना (सप्टेंबरच्या पहिल्या दिवशी, ताशकंद वेळ).
• योजना नसलेल्या खात्यांना API चा वापर करता येत नाही.
• प्रत्येक कीची स्वतःची दर मर्यादा असते (10-120 विनंती प्रति मिनिट). मर्यादेच्यापेक्षा जास्त API उत्तरे Retry-After हेडरसह 429.
• AI text generation is charged by the public price list: first from your monthly AI allowance, then from your ChatGetz balance.
• AI विनंतींसह एक Idempotency-Key हेडर पाठवा: एकाच किल्लीने पुन्हा प्रयत्न केलेल्या विनंतीची कधीही दोनदा फी आकारली जात नाही.

एंडपॉइंट्स

• get/api/v1/account/balancePlan, balance, included AI allowance and API quotaaccount:read
• get/api/v1/modelsतुमच्या किसाठी पाठ्य मॉडेल आणि त्यांच्या उपलब्धताai:generate
• post/api/v1/ai/generateपाठ्य तयार करा; बॅलन्सपासून आकारले जाते (अगोदर अनुदान समाविष्ट आहे)ai:generate
• get/api/v1/market/listingsChatGetz तुमची बाजारपेठ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. ..."
  }
}

प्लगइन

सर्व प्लगइन ओपन र्स (जीपीएल-सुसंगत) आहेत आणि तुमची API कि वापरतात. ही किल्ली प्लगइनच्या सेटिंग्जमध्ये साठवली जाते, कोडमध्ये कधीही नाही.