Saltar para o conteúdo principal
PATCH
cURL
Use este endpoint para manter cada aplicação alinhada com o cliente, a marca, o ambiente ou o caso de utilização interno que representa. Para revendedores, isto permite-lhe renomear ou atualizar cada aplicação de cliente sem partilhar credenciais entre clientes. Para clientes diretos, ajuda a separar produtos, regiões ou ambientes, mantendo tudo sob uma única organização.
Este endpoint atualiza os metadados da aplicação. O api_key mantém-se igual, a menos que faça a rotação das credenciais separadamente.

Localização dos dados

A localização dos dados da aplicação (data_location) é escolhida quando a aplicação é criada e não pode ser alterada posteriormente: uma atualização que indique a localização que a aplicação já tem é aceite, e qualquer outra localização devolve 400. A única exceção é a aplicação de produção criada juntamente com a sua organização, no registo ou através de Verificar e-mail. A primeira atualização que indique um data_location escolhe a localização, uma única vez, desde que nenhuma das chaves de API da aplicação tenha sido utilizada e a aplicação não tenha qualquer sessão de verificação. O passo Dê um nome à sua primeira aplicação da consola usa isto para guardar a localização que escolher aí. Atualmente, a única localização disponível é eu, a União Europeia (Irlanda).

Autorizações

Authorization
string
header
obrigatório

access_token JWT assinado com RS256 devolvido por POST /programmatic/login/ ou POST /programmatic/verify-email/. Envie como Authorization: Bearer <access_token>. A duração predefinida é de 86400 segundos (24h). Este token só é válido nos endpoints de Gestão de Contas em apx.didit.me/auth/v2. A API de verificação (verification.didit.me/v3) utiliza, em vez disso, a api_key de longa duração como x-api-key.

Parâmetros de caminho

org_id
string<uuid>
obrigatório

UUID da organização à qual pertence a aplicação.

Exemplo:

"a1b2c3d4-5678-90ab-cdef-111111111111"

app_id
string<uuid>
obrigatório

UUID da aplicação a atualizar.

Exemplo:

"b2c3d4e5-6789-01bc-defg-222222222222"

Corpo

application/json

Envie apenas os campos que pretende alterar. Semântica de PATCH: os campos em falta são preservados.

Corpo do PATCH para metadados da aplicação. Envie apenas os campos que pretende alterar; os campos omitidos são preservados. uuid, client_id e api_key não podem ser atualizados. products é apenas de leitura: uma chave products no corpo é ignorada. data_location não pode ser alterado após a criação da aplicação: indicar a localização que já possui é aceite, e qualquer outra localização responde com 400. A única exceção é a aplicação de produção criada com a sua organização: a primeira atualização que indique um data_location escolhe-o, uma única vez, desde que nenhuma chave de API da aplicação tenha sido utilizada e esta não tenha sessões de verificação.

name
string

Nome de apresentação da aplicação.

Exemplo:

"Acme Production App"

website_url
string

URL do website ou da aplicação associada a esta aplicação.

Exemplo:

"https://app.acme.example"

redirect_uris
string[]

URIs de redirecionamento permitidos para fluxos de redirecionamento de verificação e do tipo OAuth.

Exemplo:
terms_url
string

URL dos termos de serviço apresentado no fluxo de verificação.

privacy_url
string

URL da política de privacidade apresentado no fluxo de verificação.

description
string

Descrição interna da aplicação.

data_location
enum<string>

Onde os dados de verificação da aplicação são armazenados e processados, sendo o local selecionado quando a aplicação é criada. eu é a União Europeia (Irlanda), o padrão. au (Austrália, Sydney) e mx (México) estarão disponíveis em breve: um pedido que os indique responde 400 This data location is not available yet. A aplicação Sandbox de uma organização está sempre na União Europeia.

Opções disponíveis:
eu,
au,
mx
Exemplo:

"eu"

Resposta

Aplicação atualizada. A resposta é o registo completo da aplicação após a alteração, incluindo products; uuid, client_id e api_key mantêm-se inalterados.

Registo completo da aplicação. uuid, client_id e api_key nunca mudam após a criação. O data_location também não muda, exceto uma única vez na aplicação de produção criada com a sua organização, antes de ser utilizada (consulte o pedido de atualização).

uuid
string<uuid>

UUID da aplicação. Use como {app_id} em chamadas subsequentes.

Exemplo:

"b2c3d4e5-6789-01bc-defg-222222222222"

name
string

Nome de apresentação da aplicação exibido na consola Didit.

Exemplo:

"Acme Production App"

client_id
string

Identificador público de cliente, seguro para incorporar em fluxos do tipo OAuth.

Exemplo:

"S9LIYGSoWNuGMLHsvEt9dQ"

api_key
string

Segredo de longa duração (também chamado client_secret). Utilize como cabeçalho x-api-key para todas as chamadas a https://verification.didit.me/v3/... (sessões, fluxos, AML, etc.). Trate como uma credencial; nunca exponha no lado do cliente. As novas chaves começam com sk_live_ (aplicação de produção) ou sk_test_ (aplicação sandbox), seguidas de 43 carateres seguros para URL (letras, dígitos, - e _). As chaves criadas antes deste formato não têm prefixo e continuam a funcionar sem alterações. Durante 72 horas após recuperar a sua conta, listar, obter e atualizar devolvem uma string vazia aqui em vez da chave.

Exemplo:

"sk_live_example_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

website_url
string | null

URL do website ou da aplicação associada a esta aplicação.

Exemplo:

"https://acme.example"

redirect_uris
string[]

URIs de redirecionamento permitidos para fluxos de redirecionamento de verificação e do tipo OAuth.

Exemplo:
terms_url
string | null

URL dos termos de serviço apresentado no fluxo de verificação.

Exemplo:

"https://acme.example/terms"

privacy_url
string | null

URL da política de privacidade apresentado no fluxo de verificação.

Exemplo:

"https://acme.example/privacy"

description
string | null

Descrição interna da aplicação (não visível para os utilizadores finais).

created_at
string<date-time>
Exemplo:

"2025-06-01T10:00:00Z"

data_location
enum<string>

Onde os dados de verificação da aplicação são armazenados e processados, sendo o local selecionado quando a aplicação é criada. eu é a União Europeia (Irlanda), o padrão. au (Austrália, Sydney) e mx (México) estarão disponíveis em breve: um pedido que os indique responde 400 This data location is not available yet. A aplicação Sandbox de uma organização está sempre na União Europeia.

Opções disponíveis:
eu,
au,
mx
Exemplo:

"eu"

products
object[]
read-only

Os produtos da aplicação. Sempre todos os três, por esta ordem: identity, transactions, authentication. Uma nova aplicação tem identity ativado com todos os módulos ligados, e transactions e authentication desativados. Só de leitura: uma chave products no corpo de criação ou atualização é ignorada.

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