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

احراز هویت و دامنه

هر درخواست نیازمند یک کلید شخصی API در سرآیند Authorization: Bearer cgk_… (یا X-API-Key) است. هر کلید مجوزها (حدود) و محدودیت نرخ خود را دارد و می‌تواند در هر زمان لغو شود.

کلیدها را روی سرور یا تنظیمات پلاگین خود نگه دارید، هرگز در کد جلویی عمومی قرار نگیرید. ChatGetz تنها یک هش SHA-256 از هر کلید ذخیره می کند.

محدودیت‌ها و قیمت‌گذاری، تعرفه‌ها

• Global Pro: درخواست‌های API نامحدود.
• Basic: ۱٬۰۰۰ درخواست در هر ماه (تنظیمات در زمان 1st، Tashkent).
• حساب‌های بدون برنامه دسترسی به شماره API ندارند.
• هر کلید محدودیت نرخ خود را دارد (10–120 در دقیقه). درم بالاتر از این حد، API به 429 با سرآیند Retry-After پاسخ می‌دهد.
• تولید متن AI توسط لیست قیمت عمومی شارژ می شود: اول از کمک هزینه ماهانه شما، سپس از تعادل ChatGetz شما.
• ارسال یک هدر Idempotency-Key با درخواست های AI: درخواست مجدد با همان کلید هرگز دو بار شارژ نمی شود.

نقاط پایانی، نقطه‌های پایان

• get/api/v1/account/balanceبرنامه، توازن، شامل کمک هزینه هوش مصنوعی و کوته‌ی APIaccount: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.jsonمشخصات OpenAPI 3٫1 این API.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 شما استفاده می‌کنند. کلید در تنظیمات پلاگین ذخیره می‌شود، هرگز در کد.