OmniLink API
Tasks

Consulta status de uma task do tenant

Busca por id + hash da API key. Task de outro tenant retorna 404 (isolamento). `status` persistido: pending, processing, completed, failed. `result` e dict livre (formato depende de `kind`). `error`/`error_type`/`attempts` vem do registro da task.

GET
/v1/tasks/{task_id}/status

Busca por id + hash da API key. Task de outro tenant retorna 404 (isolamento). status persistido: pending, processing, completed, failed. result e dict livre (formato depende de kind). error/error_type/attempts vem do registro da task.

Authorization

ApiKeyAuth
x-api-key<token>

Tenant key. Nao e JWT. Qualquer valor nao-vazio identifica um tenant via SHA-256. Ausencia => 401 API key ausente. Nao ha lista de chaves validas.

In: header

Path Parameters

task_id*string

ID da task (uuid.uuid4().hex, 32 caracteres hexadecimais).

Match^[0-9a-f]{32}$
Length32 <= length <= 32

Header Parameters

x-api-key*string

Identificador do tenant. Qualquer string nao-vazia e aceita; a API armazena apenas o SHA-256. Nao ha cadastro/validacao de chave. Chave diferente = tenant diferente (isolamento).

Length1 <= length

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/tasks/a1b2c3d4e5f6789012345678abcdef01/status" \  -H "x-api-key: sua-api-key"

{  "task_id": "a1b2c3d4e5f6789012345678abcdef01",  "status": "pending",  "result": {},  "error": "",  "error_type": "",  "attempts": 0}

Enfileira captura de HTML renderizado (Playwright) POST

Task `kind=fetch_html` (`run_fetch_html_task`). Plataforma deve estar em SUPPORTED_PLATFORMS. `wait_until` se enviado: load | domcontentloaded | networkidle | commit (senao 400). Defaults Pydantic: wait_ms_after_load=5000 (0..120000), enable_scroll=true, strip_scripts=true, max_html_chars=1500000 (10000..5000000). Na Amazon o worker pode elevar wait_ms_after_load para 12000 e incluir `selector_hints` / `amazon_price_nodes` no result. Nao ha 404 neste handler.