ChatGetz API cho các nhà phát triển

Bắt đầu nhẹ nhàng

1. Truy cập và mở Dashboard → API.
2. Tạo một khóa với quyền hạn bạn cần và sao chép nó (nó chỉ được hiển thị một lần).
3. Gửi nó trong mục đầu 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)."
  }'

Xác thực và phạm vi

Mỗi yêu cầu cần một khóa API cá nhân trong phần đầu Authorization: Bearer cgk_… (hoặc X-API-Key). Mỗi chìa khóa có quyền truy cập (tầm ảnh hưởng) và giới hạn tốc độ riêng của nó và có thể bị hủy bỏ bất cứ lúc nào.

Giữ các chìa khóa trên máy chủ hoặc trong cài đặt plugin, không bao giờ ở mã front-end công cộng. ChatGetz chỉ lưu trữ một hàm băm SHA-256 của mỗi chìa khóa.

Giới hạn và giá cả

• Global Pro: yêu cầu không giới hạn API.
• Basic: 1.000 yêu cầu mỗi tháng (đặt lại vào ngày 1, giờ Tashkent).
• Các tài khoản không có kế hoạch không được truy cập vào API.
• Mỗi khóa có giới hạn tốc độ riêng (10–120 yêu cầu mỗi phút). Vượt quá giới hạn, API trả lời 429 với đầu Retry-After.
• Tạo văn bản AI được tính theo superficie: đầu tiên từ khoản trợ cấpI hàng tháng, sau đó là số dư ChatGetz.
• Simula Carrier: simulcar, simacor.

Các điểm cuối

• get/api/v1/account/balanceKế hoạch, cân bằng, bao gồm khoản phụ cấp AI và hạn ngạch APIaccount:read
• get/api/v1/modelsCác mô hình văn bản và khả năng sử dụng của chúng cho khóa của bạnai:generate
• post/api/v1/ai/generateTạo văn bản; tính từ số dư (bao gồm thêm khoản phụ cấp trước)ai:generate
• get/api/v1/market/listingsDanh sách ChatGetz Market của bạnmarket:read
• post/api/v1/market/listingsTạo một danh sách thị trường (mặc định là bản thảo)market:write
• post/api/v1/ingest/eventsThưởng thức một đơn hàng hoặc khách từ plugin (webhook)ingest:write
• get/api/v1/openapi.jsonĐặc tính OpenAPI 3.1 của API này

Plugins đẩy các lệnh mới và dẫn đến POST /api/v1/ingest/events. Gửi lại một sự kiện với cùng nguồn, kiểu và external koluan an toàn: nó chỉ được lưu trữ một lần.

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

Lỗi

Lỗi là JSON với mã đọc máy ổn định và thông báo bằng tiếng Anh. Tạo việc tích hợp của bạn trên mã.

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

Plugins

Tất cả các plugin đều là mã nguồn mở (hợp vớiGPL) và sử dụng khóa API của bạn. Chìa khóayagửi trong cài đặt plugin, không bao giờ ở mã.