Introducción

Kaptra ofrece una API REST compatible con CapSolver. Todas las llamadas son POST con un cuerpo JSON. El estado HTTP siempre es 200; el éxito y los errores se indican en errorId (0 o 1) y errorCode.

Autenticación

Incluye clientKey en el cuerpo JSON. No envíes un encabezado Authorization.

Respuesta síncrona o consulta periódica

• Algunos tipos (actualmente, AntiAwsWafTask) devuelven status=ready desde /createTask.
• Los demás son asíncronos: /createTask devuelve status=processing y un taskId. Consulta /getTaskResult cada 1–2 segundos, como máximo 120 veces.

Ejemplo mínimo

POST /createTask
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "ImageToTextTask",
    "body": "BASE64_ENCODED_IMAGE"
  }
}