डेवलपर्स के लिए 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 में एक व्यक्तिगत API कुंजी की आवश्यकता होती है: Bearer cgk_… हेडर (या X-API-Key)। प्रत्येक कुंजी की अपनी अनुमति (स्कोप) और दर सीमा होती है और इसे किसी भी समय रद्द कर दिया जा सकता है।

अपने सर्वर पर या प्लगइन सेटिंग्स में कुंजी रखें, कभी सार्वजनिक फ्रंट-एंड कोड में नहीं। ChatGetz प्रत्येक कुंजी के केवल SHA-256 हैश स्टोर करता है।

सीमाएं और मूल्य निर्धारण

• Global Pro: असीमित API अनुरोध।
• Basic: प्रति माह 1,000 अनुरोध (1st, Tashkent समय पर सेट)।
• योजना के बिना खाताधारकों को API तक पहुंच नहीं है।
• प्रत्येक कुंजी की अपनी दर सीमा होती है (10-120 अनुरोध प्रति मिनट)। सीमा से अधिक API एक फिर कोशिश-बाद हेडर के साथ 429 का जवाब देता है।
• एआई पाठ पीढ़ी को सार्वजनिक मूल्य सूची द्वारा चार्ज किया जाता है: पहले आपकी मासिक एआई भत्ता से, फिर आपके ChatGetz शेष से।
• एआई अनुरोध के साथ एक Idempotency-कुंजी शीर्षलेख भेजें: उसी कुंजी के साथ एक सेवानिवृत्त अनुरोध को दो बार चार्ज नहीं किया जाता है।

अंत बिंदु

• get/api/v1/account/balanceयोजना, संतुलन, एआई भत्ता और 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.jsonOpenAPI 3.1 इस API के विनिर्देश

पेलाग्नस नए आदेशों को दबाता है और POST /api/v1/ingest/events. के लिए जाता है एक ही स्रोत, प्रकार और 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. ..."
  }
}

प्लगइन

सभी प्लगइन ओपन सोर्स (जीपीएल-संगत) हैं और आपकी API कुंजी का उपयोग करते हैं। कुंजी कोड में नहीं, प्लगइन सेटिंग्स में संग्रहित की जाती है.