ChatGetz API ئىجادىيەتچىلەر ئۈچۈن

تېز باشلاش

1. كىرىڭ ۋە Dashboard → 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 ئاچقۇچى كېرەك. ھەر بىر ئاچقۇچنىڭ ئۆزىنىڭ رۇخسىتى (كۆلىمى) ۋە نىسبەتلىك چەكلىمىسى بار بولۇپ، ھەرقانداق ۋاقىتتا بىكار قىلىنغىلى بولىدۇ.

ئاچقۇچلارنى خېرىدارىڭىزدا ياكى -in تەڭشەكلىرىنىڭ ئىچىدە ساقلىسۇن، ھېچقاچان كەڭ ئاممىنىڭ ئالدىنقى تەرىپىدىكى كودتا قالمىسۇن. ChatGetz ھەر بىر ئاچقۇچنىڭ پەقەتلا SHA-256 ھەشلىرىنى ساقلايدۇ.

چەكلىمىلەر ۋە باھالار

• Global Pro: چەكسىز API تەلەپ.
• Basic: ھەر ئايدا 1,000 سورالغان (تاشكەنت ۋاقتى بويىچە ئاينىڭ 1-كۈنى قايتا تەڭشەلىدۇ).
• Accounts without a plan have no API access.
• ھەر بىر ئاچقۇچنىڭ ئۆزىنىڭ سۈرئەتلىك چەكلىمىسى بار (بىر مىنۇتتا 10-120 تەلەپ). چەكتىن ئاشقاندا، API 429 غا Retry-After تېمىسى بىلەن جاۋاب بېرىدۇ.
• AI تېكىست ياساش خىزمەتلىرى خەلقئارالىق باھا تىزىملىكى بويىچە ھەق ئېلىنىدۇ: ئالدى بىلەن ئايلىق AI مۇكاپاتىڭىزدىن، ئاندىن ChatGetz ھېساباتىڭىزدىن.
• Send an Idempotency-Key header with AI requests: a retried request with the same key is never charged twice.

Endpoints

• 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: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بۇ API.1 نى كۆرسىتىدىغان OpenAPI 3.1 خاراكتېرلىك مەشغۇلات سىستېمىىسىنىڭ ئىسمى بولىدۇ

قىستۇرما يېڭى بۇيرۇقلارنى قوزغايدۇ ۋە 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. ..."
  }
}

قوشۇمچە پروگرامما

پۈتۈن قىستۇرمىلارنىڭ مەنبەسى ئوچۇق (GPL بىلەن ماسلىشىدۇ) ۋە API ئاچقۇچى ئىشلىتىلىدۇ. ئاچقۇچى قوشۇمچە تەڭشەكلىرىدە ساقلىنىدۇ، ھەرگىزمۇ كودتا ئەمەس.