Skip to main content
GET
/
batch-import
/
user-event-jobs
/
{jobId}
/
failures
Falhas batch de eventos de usuário
curl --request GET \
  --url http://api.gu1.ai/batch-import/user-event-jobs/{jobId}/failures \
  --header 'Authorization: Bearer <token>'

Endpoints

GET https://api.gu1.ai/batch-import/user-event-jobs/{jobId}/failures.csv
GET https://api.gu1.ai/batch-import/user-event-jobs/{jobId}/failures
  • …/failures.csv → download CSV
  • …/failures → JSON

Autenticação e permissões

Authorization: Bearer SUA_API_KEY
Requer pelo menos um de: transactions:create, entities:bulk_import, events:create.

Respostas HTTP

CódigoQuando
200Job encontrado
401Sem autenticação
403Sem permissão
404Job não encontrado

Colunas CSV

ColunaDescrição
row_keyId da linha fonte (p. ex. row_5 = linha 5 do CSV)
codeCódigo estável — catálogo
errorMensagem legível

Resposta JSON

Mesmo envelope que Falhas batch de transações, com kind: user_event_batch e linhas:
{
  "success": true,
  "jobId": "…",
  "kind": "user_event_batch",
  "status": "completed",
  "totalItems": 50,
  "succeeded": 49,
  "failed": 1,
  "skipped": 0,
  "failures": [
    {
      "rowKey": "row_5",
      "code": "VALIDATION_ERROR",
      "message": "Campo obrigatório vazio"
    }
  ],
  "truncated": false,
  "failuresTotal": 1
}
Códigos típicos: VALIDATION_ERROR, ENTITY_NOT_FOUND, PROCESSING_ERROR. Ver também: Importar eventos, Códigos de falha.