ChatGetz API for developers

სწრაფი დაწყება

1. Sign in and open Dashboard → API keys.
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). თითოეულ ღილაკს აქვს საკუთარი უფლებამოსილება (შე ) და სიჩქარის ლიმიტი და ნებისმიერ დროს შეიძლება გაუქმდეს.

Keep keys on your server or in plugin settings, never in public front-end code. ChatGetz stores only a SHA-256 hash of each key.

ლიმიტები და ფასები

• Global Pro: უსაზღვრო API მოთხოვნა.
• Basic: 1000 მოთხოვნა თვეში (სერვიზდება პირველი დღის თაშქენტის დროით).
• ანგარიშებს, რომლებსაც არ აქვთ გეგმა, არ აქვთ API-ის წვდომა.
• თითოეულ ღილაკს აქვს საკუთარი სიჩქარის ლიმიტი (10–120 მოთხოვნა წუთში). API პასუხობს 429-ს Retry-After სათაურით.
• AI ტექსტის გენერირება ფასდება საზოგადოებრივი ფაილური მიხედვით: პირველ რიგში თქვენი თვეში AI დაფინანსებიდან, შემდეგ კი თქვენი 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/listingsთქვენი ChatGetz Market-ის სიები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.-მდე მოვლენის განმეორებითი გაგზავნა იგივე წყაროს, ტიპისა და 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 გასაღებს. გასაღები დაცულია პლაგინის კონფიგურაციაში, არასდროს კოდში.