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 ለመድረስ የሌላቸው ሒሳቦች ምንም ዓይነት ዕቅድ የላቸውም.
• ቁልፍ ሁሉ የራሱ የሆነ የክፍያ መጠን አጠቃቀም አለው። ከስልጣን በላይ በAPI 429 ላይ መልሶ ለመመለስ የሚሞክር በኋላ ያለውን የራስጌ አናት መለየት ይችላል።
• የ AI ጽሑፍ ማምረት በሕዝብ ዋጋ ዝርዝር ይከፈለዋል: - የመጀመሪያው ከወርሃዊው AI ክፍያዎ፣ ከዚያም ከ ChatGetz ዎ.
• Send an Idempotency-Key header with AI requests: a retried request with the same key is never charged twice.

የመጨረሻ ነጥቦች

• 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/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

/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 ቁልፍዎን ይጠቀማሉ ፡፡ ቁልፉ በፕላጊን ማስተካከያዎች ውስጥ ይገኛል ፣ ፈጽሞ በኮድ ውስጥ አይደለም ፡፡