Saltar para o conteúdo principal
PATCH
curl
As ligações pré-assinadas em extra_files expiram. Obtenha novas a partir da decisão da sessão quando precisar dos ficheiros mais tarde. Para corrigir os dados extraídos de um documento, use Atualizar dados da sessão.

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

sessionId
string<uuid>
obrigatório

UUID da sessão de Verificação de utilizadores (KYC) à qual adicionar o ficheiro (o session_id retornado por POST /v3/session/). O ID de uma sessão de Verificação de empresas (KYB) devolve 404.

Exemplo:

"11111111-2222-3333-4444-555555555555"

Corpo

multipart/form-data
file
file
obrigatório

A imagem ou PDF. Extensões permitidas: jpg, jpeg, png, webp, tiff, pdf. No máximo 15 MB aquando do carregamento; o ficheiro é depois comprimido e rejeitado com 400 se continuar a ter mais de 2 MB (2 097 152 bytes). Ficheiros vazios são rejeitados.

model_type
enum<string>
obrigatório

kyc adiciona o ficheiro ao resultado da Verificação de identidade, poa ao resultado do Comprovativo de morada.

Opções disponíveis:
kyc,
poa
Exemplo:

"kyc"

file_password
string

Palavra-passe de um PDF encriptado. Sem ela, ou com uma incorreta, um PDF encriptado devolve 400.

Resposta

Ficheiro adicionado. Devolve todos os ficheiros adicionais desse resultado, incluindo o novo.

extra_files
(string<uri> | null)[]
obrigatório

Ligações pré-assinadas de curta duração para todos os ficheiros adicionais do resultado designado por model_type, do mais antigo para o mais recente. Cada ligação é null para uma chave de API com âmbito restrito sem media: read. Obtenha ligações atualizadas posteriormente a partir da decisão da sessão.

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