ChatGetz API for developers

দ্রুত শুরু করুন

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)."
  }'

অনুমোদন এবং পরিধি

Every request needs a personal API key in the Authorization: Bearer cgk_… header (or X-API-Key). Each key has its own permissions (scopes) and rate limit and can be revoked at any time.

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 দায়বদ্ধতা: প্রতি মাসে ১,০০০টি অনুরোধ (মারকগ পরিকগম, তাশখন্দের ইউনিসেফ)।
• প্ল্যানবিহীন অ্যাকাউন্টের জন্য API-এ প্রবেশাধিকার নেই।
• প্রতিটি কী-এর নিজস্ব হার সীমা (প্রতি মিনিটে 10–120টি অনুরোধ) আছে। সীমা অতিক্রম করে API রিটায়ার-এফটার হেডার সহ 429 এর উত্তর দেয়।
• এআই টেক্সট জেনারেশনের জন্য পাবলিক মূল্য তালিকা অনুযায়ী চার্জ নেওয়া হয়: প্রথমে আপনার মাসিক এআই বেতন থেকে, তারপর আপনার ChatGetz ব্যালেন্স থেকে।
• AI অনুরোধের সাথে একটি Idempotency-Key হেডার প্রেরণ করুন: একই কী ব্যবহার করে পুনরায় অনুরোধ করলে কখনোই দুইবার চার্জ নেওয়া হয় না।

এন্ডপয়েন্টস

• 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.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" }]
  }'

ত্রুটি

Errors are JSON with a stable machine-readable code and an English message. Build your integration on the code.

{
  "error": {
    "code": "quota_exceeded",
    "message": "Monthly Basic API quota exhausted. ..."
  }
}

প্লাগইন

সব প্লাগইন উন্মুক্ত উৎস (জিপিএল-সামঞ্জস্যপূর্ণ) এবং আপনার API কী ব্যবহার করে। কীটি প্লাগইন সেটিংসে সংরক্ষিত থাকে, কোডে কখনওই না।