Nora AI

Executar Extração

Envia um documento para ser processado por um agente. O processo é assíncrono — retorna imediatamente com um código de rastreamento para polling.

POST
/agents/{code}/execute
x-api-key<token>

Chave de API para acesso programático. Obtida via dashboard.

In: header

Path Parameters

code*string

Código do agente (10 caracteres, gerado na criação).

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api.nora.dclick.com.br/agents/aB3cD4eF5g/execute" \  -H "Content-Type: application/json" \  -d '{    "content": "JVBERi0xLjQKJcOkw7zD...",    "mimeType": "application/pdf",    "fileName": "nota-fiscal-001.pdf"  }'
{
  "trackingCode": "aB3cD4eF5gH7",
  "extractionId": "019462a1-b2c3-7d4e-8f5a-6b7c8d9e0f1a",
  "status": "pending",
  "message": "Extração enfileirada com sucesso. Use o código de rastreamento para acompanhar o progresso."
}

{
  "error": "Este agente está desativado.",
  "code": "AGENT_INACTIVE"
}

{
  "error": "Não autorizado.",
  "code": "UNAUTHORIZED"
}
{
  "error": "Agente não encontrado.",
  "code": "AGENT_NOT_FOUND"
}
{
  "error": "Limite de requisições excedido. Tente novamente mais tarde.",
  "code": "API_KEY_RATE_LIMITED",
  "tryAgainIn": 42350
}
{
  "error": "Falha ao enfileirar a extração. Tente novamente.",
  "code": "QUEUE_ENQUEUE_FAILED"
}