ChatGetz API para desenvolvedores

Começo rápido

1. Faça login e abra o Painel → API chaovuas.
2. Crie uma chave com as permissões necessárias e copie-a (é mostrada apenas uma vez).
3. Envie-o no cabeçalho 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)."
  }'

Autenticação e escopos

Cada solicitação precisa de uma chave pessoal API no cabeçalho Authorization: Bearer cgk_… (ou X-API-Key). Cada chave tem suas próprias permissões (escopos) e limite de taxa e pode ser revogada a qualquer momento.

Mantenha as chaves no seu servidor Unifi ou nas configurações de plugins, nunca em código de front-end público. ChatGetz armazena apenas um hash SHA-256 de cada chavegrega.

Limites e definição de preços

• Global Pro: pedidos ilimitados de API.
• Basic: 1.000 solicitações por mês (reinicializa no dia 1, hora de Tashkent).
• As contas sem um plano não têm acesso ao API.
• Cada chave tem seu próprio limite de taxa (10 a 120 por minuto). Acima do limite, o API responde ao 429 com um cabeça Retry-After.
• A geração de texto AI é cobrada pela lista pública de preços: primeiro do seu subsídio mensal para IA, depois do saldo ChatGetz.
• Enviar um cabeçalho Idempotency-Key com solicitações de IA: uma nova tentativa de solicitação com a mesma chave nunca é cobrada duas vezes.

Endpoints

• get/api/v1/account/balancePlano, saldo, incluindo subsídio de AI e cota APIaccount:read
• get/api/v1/modelsModelos de texto e sua disponibilidade para a chave que você escolherai:generate
• post/api/v1/ai/generateGerar texto; cobrado do saldo (incluído primeiro)ai:generate
• get/api/v1/market/listingsYour ChatGetz Market listingsmarket:read
• post/api/v1/market/listingsCrie uma listagem no Mercado (um rascunho por padrão)market:write
• post/api/v1/ingest/eventsReceber um pedido ou lead de um plugin (webhook)ingest:write
• get/api/v1/openapi.jsonA especificação OpenAPI 3.1 deste API

Plugins enviam novos pedidos e levam ao POST /api/v1/ingest/events. Reenviar um evento com a mesma origem, tipo e externalId é seguro: ele só é armazenado uma vez.

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

Erros

Os erros são JSON com um código estável legível por máquina e uma mensagem em inglês. Construa sua integração no código.

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

Plugins

Todos os plugins são de código aberto (compatíveis com GPL) e usam sua chave API. A chave é armazenada nas configurações do plugin, nunca no código.