ChatGetz API para desarrolladores

Inicio rápido

1. Inicie sesión y abra Dashboard → API claves.
2. Cree una clave con los permisos que necesita y cópiela (se muestra solo una vez).
3. Envíelo en el encabezado 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)."
  }'

Autenticación y ámbitos

Cada solicitud necesita una clave personal API en el encabezado Authorization: Bearer cgk_… (o X-API-Key). Cada clave tiene sus propios permisos (scopios) y límite de tarifas y se puede revocar en cualquier momento.

Mantenga las teclas en su servidor o en la configuración del plugin, nunca en el código de entrada público. ChatGetz almacena sólo un SHA-256 hash de cada llave.

Límites y precios

• Global Pro: solicitudes ilimitadas de API.
• Basic: 1,000 solicitudes por mes (reservas en el primer, tiempo de Tashkent).
• Las cuentas sin un plan no tienen acceso al formulario API.
• Cada clave tiene su propio límite de velocidad (10-120 solicitudes por minuto). Por encima del límite, el API responde a la llamada de 429 con un encabezado Retry-After.
• La generación de texto AI está cargada por la lista de precios públicos: primero de su asignación mensual de IA, luego de su saldo ChatGetz.
• konfesión de la clave: una solicitud reintentada con la misma clave nunca se cobra dos veces; envía un encabezado Idempotency-Key con las solicitudes AI.

Puntos finales

• get/api/v1/account/balancePlan, saldo, incluido subsidio de IA y cuota APIaccount:read
• get/api/v1/modelsModelos de texto y su disponibilidad para tu claveai:generate
• post/api/v1/ai/generateGenerar texto; cargado del saldo (incluida la asignación primero)ai:generate
• get/api/v1/market/listingsSus anuncios en el mercado ChatGetzmarket:read
• post/api/v1/market/listingsCrear un listado en el mercado (un borrador por defecto)market:write
• post/api/v1/ingest/eventsRecibir un pedido o una oportunidad de venta desde un plugin (webhook)ingest:write
• get/api/v1/openapi.jsonLa especificación OpenAPI 3.1 de este API

Los plugins envían nuevas órdenes y dan lugar a POST /api/v1/ingest/events. Reenviar un evento con el mismo origen, tipo e externalId es seguro: solo se almacena una 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" }]
  }'

Errores

Los errores son JSON con un código estable legible por máquina y un mensaje en inglés. Cree su integración en el código.

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

Plugins

Todos los plugins son de código abierto (compatible con GPL) y utilizan su clave API. La clave se almacena en la configuración del plugin, nunca en el código.