ChatGetz API 開発者向け

クイックスタートです

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

認証とスコープ、認証の範囲

すべてのリクエストには、Authorization:Bearer cgk_…ヘッダ（またはX-API-Key）に個人的な鍵APIが必要である。それぞれのキーには独自の権限（スコープ）と/制限があり、いつでも取り消すことができる。

キーをサーバまたはプラグインの設定に保存し、公開フロントエンドコードには入れない。ChatGetzは各鍵のSHA-256ハッシュだけを保存する。

制限と価格設定

• Global Pro:無制限のAPIリクエスト。
• Basic:月に1,000件のリクエスト回（タシュケント時間の1日目にリセット）。
• プランなしの口座はAPIにアクセスできない。
• それぞれのキーには独自のレート制限（10～120リクエスト/分）がある。制限を超えると、APIは429にRetry-Afterヘッダで応答する。
• 人工知能のテキスト生成は、あなたの月間の手当から最初に、あなたのChatGetz残高から公開価格リストによって行われます。
• AIリクエストと共にIdempotency-Keyヘッダを送信する: 同じ鍵で再試みしたリクエストは二度と請求されない。

エンドポイント。エンドポイントは、ユーザのデータベースを管理するため

• 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/listingsChatGetzマーケットのリストですmarket:read
• post/api/v1/market/listingsマーケットリストを作成する(デフォルトでドラフト)market:write
• post/api/v1/ingest/eventsプラグイン（ウェブホーク）から注文またはリードを受け取るingest:write
• get/api/v1/openapi.jsonOpenAPIの3.1仕様はこの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. ..."
  }
}

プラグイン

はオープンソースであり、APIキーを使用する。キーはコードではなくプラグインの設定に保存されます。