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의 개인 API 키가 필요합니다. Bearer cgk_… 헤더 (또는 X-API-Key). 각 키에는 자체 허가 (경찰) 및 속도 제한이 있으며 언제든지 수정할 수 있습니다.

서버 또는 플러그인 설정에서 키 유지, 공공 프런트 엔드 코드에서 절대. ChatGetz 매장은 각 키의 SHA-256 해시만 저장합니다.

제한 및 가격

• Global Pro: 무제한 API 요청.
• Basic: 달 당 1,000개의 요청이 이루어졌습니다 (제 1에, Tashkent 시간).
• 계획이 없는 계정은 API에 액세스할 수 없습니다.
• 각 키에는 자체 속도 제한이 있습니다 (10-120 분당 요청). 제한 이상 API 답변 429 후 헤더.
• AI 텍스트 생성은 공개 가격 목록에 의해 청구됩니다: 월별 AI 수당에서 첫 번째, 그 후 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/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.jsonOpenAPI 3.1 이것의 특징 API

플러그인 푸시 새로운 주문 및 POST /api/v1/ingest/events.에 리드 동일한 소스, 유형 및 ExternalId와 이벤트를 Resending 안전: 그것은 한 번만 저장됩니다.

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 키를 사용합니다. 키는 코드에 저장되지 않고, 플러그인 설정에 저장됩니다.