Saltar para o conteúdo principal
POST
Python
Uma nova tentativa da API assíncrona de Relatórios volta a executar uma exportação ou coloca em fila os itens de verificação com falha selecionados. Uma nova tentativa devolve 201; uma seleção idêntica de itens com falha devolve o relatório existente com 200.
A tentativa seletiva exige a identidade do utilizador que fez o pedido original. Uma chave de API ou um token da aplicação sem essa identidade recebe 403 ao enviar item_ids, mesmo para a sua própria aplicação. O exemplo gerado com uma chave de API volta a executar a exportação completa com um corpo vazio.
Obtenha os IDs ativos em Obter relatório assíncrono e siga as orientações para tentar novamente os itens com falha. Envie de 1 a 1000 IDs de uma SESSION_EXPORT com estado READY ou FAILED, sem um intervalo de datas alternativo. Não é possível tentar novamente sessões eliminadas.

Autorizações

x-api-key
string
header
obrigatório

A chave de API da sua aplicação, a partir de Programadores -> Chaves de API na Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter o âmbito definido: nenhum, leitura ou escrita por recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está incorreta, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que o pedido veio de um endereço fora da sua lista de IP; 404 numa rota de sessão significa que a sessão está fora dos fluxos ou estados da chave. Uma chave sem acesso a multimédia recebe URLs de imagens, vídeos e PDFs como nulos, e uma chave sem permissão de escrita em sessões recebe ligações de sessão e tokens como nulos. Consulte https://docs.didit.me/console/api-keys.

Parâmetros de caminho

organization_id
string<uuid>
obrigatório

Identificador da organização.

application_id
string<uuid>
obrigatório

Identificador da aplicação.

report_uuid
string<uuid>
obrigatório

UUID do relatório.

Corpo

application/json
item_ids
string<uuid>[]

Seleção opcional de 1 a 1000 UUIDs de sessões de produção com falha desta exportação. Os duplicados são eliminados. Apenas o requerente original pode voltar a tentar um subconjunto. Não pode ser combinado com date_from/date_to.

Required array length: 1 - 1000 elements
date_from
string<date>

Opcional: nova data de início do período. Envie ambas as datas por ordem; omita para uma nova tentativa de itens com falha.

date_to
string<date>

Opcional: nova data de fim do período, igual ou posterior a date_from.

notify_on_ready
boolean
padrão:false

Enviar um e-mail ao solicitante quando estiver pronto, se houver um e-mail do solicitante disponível.

Resposta

Reprodução de uma seleção de itens falhados idêntica; devolve o relatório de nova tentativa existente sem colocar outro em fila.

uuid
string<uuid>
obrigatório

Identificador do relatório.

report_type
enum<string>
obrigatório

Tipo de exportação ou de relatório de conformidade.

Opções disponíveis:
SESSION_EXPORT,
TRANSACTION_EXPORT,
BUSINESS_EXPORT,
VENDOR_USER_EXPORT,
VENDOR_BUSINESS_EXPORT,
CASE_EXPORT,
CASE_SLA_EXPORT,
LIST_ENTRY_EXPORT,
EVENT_EXPORT,
COMPLIANCE_KYC_KYB,
COMPLIANCE_AML_LOG,
COMPLIANCE_TRAVEL_RULE,
COMPLIANCE_SANCTIONS_PEP,
COMPLIANCE_RISK_SUMMARY,
COMPLIANCE_SAR_STR_DRAFT,
COMPLIANCE_CTR,
COMPLIANCE_CASE_SUMMARY
report_type_display
string
obrigatório

Rótulo apresentado para o tipo de relatório.

status
enum<string>
obrigatório

Estado da geração. READY pode incluir falhas individuais; verifique failed_count.

Opções disponíveis:
PENDING,
PROCESSING,
READY,
FAILED
status_display
string
obrigatório

Rótulo apresentado para o estado da geração.

parameters
object
obrigatório

Opções originais da exportação; as chaves dependem de report_type.

requested_by_user_id
string<uuid> | null
obrigatório

Identidade original do requerente, ou null para chamadores sem identidade de utilizador.

requested_by_email
string | null
obrigatório

E-mail do requerente, quando disponível.

requested_by_name
string | null
obrigatório

Nome de apresentação do requerente, quando disponível.

row_count
integer | null
obrigatório

Número de registos exportados, ou null antes da geração.

failed_item_ids
string<uuid>[]
obrigatório

UUIDs das sessões de produção que falharam nesta exportação de verificação. As sessões eliminadas são excluídas. Utilize estes IDs para uma nova tentativa seletiva.

failed_count
integer
obrigatório

Número de entradas em failed_item_ids.

Intervalo necessário: x >= 0
file_size
integer<int64> | null
obrigatório

Tamanho total do ficheiro gerado em bytes, ou null antes da geração.

files
object[]
obrigatório

Metadados do ficheiro gerado; não contém URLs de transferência.

scheduled_report
string<uuid> | null
obrigatório

Identificador do agendamento, ou null para um relatório não agendado.

error_message
string | null
obrigatório

Erro de geração, quando disponível.

deletion_pending
boolean
obrigatório

Indica se uma eliminação solicitada ainda está em curso.

eta_seconds
integer | null
obrigatório

Tempo estimado, em segundos, até à conclusão de um relatório pendente ou em processamento; nulo sem histórico ou quando concluído.

started_at
string<date-time> | null
obrigatório

Data e hora de início da geração.

completed_at
string<date-time> | null
obrigatório

Data e hora de conclusão da geração.

expires_at
string<date-time>
obrigatório

Hora de expiração do relatório.

created_at
string<date-time>
obrigatório

Data e hora de criação.

updated_at
string<date-time>
obrigatório

Data e hora da última atualização.

Última modificação em 14 de novembro de 2026