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 בקשות לחודש (סעיפים על 1st, Tashkent Time)
• לחשבונות ללא תוכנית אין גישה ל-API.
• לכל מפתח יש מגבלת קצב משלו (10 עד 120 בקשות לדקה). על פני הגבול API תשובות 429 עם Retry-After Header.
• דור טקסט של בינה מלאכותית מואשם על ידי רשימת המחירים הציבוריים: ראשית מקצבת הבינה המלאכותית החודשית שלך, ואז ממאזן ChatGetz שלך.
• שלח ראש צוות של Idempotency-Key עם בקשות AI: בקשה מחודשת עם אותו מפתח לעולם לא מואשם פעמיים.

נקודות קצה: נקודת הסוף

• 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/listingsChatGetz רשומות שוקmarket:read
• post/api/v1/market/listingsיצירת רשימת שוק (ברירת מחדל, טיוטה)market:write
• post/api/v1/ingest/eventsReceive an order or lead from a plugin (webhook)ingest:write
• get/api/v1/openapi.jsonהמפרט OpenAPI 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. ..."
  }
}

תוספים

כל התוספים הם קוד פתוח (GPL-תואמים) ולהשתמש במפתח API שלך. המפתח מאוחסן בהגדרות התוסף, אף פעם לא בקוד.