Saltar para o conteúdo principal
POST
cURL
Use este endpoint quando precisar de separar o tráfego de verificação, as credenciais, a identidade visual ou os relatórios dentro da mesma organização. Isto é especialmente útil para revendedores que criam uma aplicação por cliente. Também funciona bem quando a sua empresa tem vários produtos, marcas, regiões, ambientes de preparação e de produção, ou casos de utilização que não devem partilhar a mesma chave de API nem as mesmas definições ao nível da aplicação.
Todos os endpoints da Auth API usam https://apx.didit.me/auth/v2. Use o api_key devolvido como x-api-key ao chamar os endpoints https://verification.didit.me/v3/..., como os endpoints de sessões e de fluxos.

Localização dos dados

Cada aplicação armazena e processa os seus dados de verificação num único local (a localização dos dados), escolhido ao criar a aplicação com data_location. Atualmente, a única localização disponível é eu, a União Europeia (Irlanda), que também é a predefinida se omitir o campo. A Austrália (Sydney, au) e o México (mx) estão para breve: um pedido que as indique recebe uma resposta 400 This data location is not available yet. e não cria nada. Cada consulta à aplicação devolve o seu data_location, e este não pode ser alterado depois de a aplicação ser criada. Consulte Localização dos dados.

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. Consulte-o com GET /organizations/me/.

Exemplo:

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

Corpo

application/json

Todos os campos são opcionais. Omitir o corpo cria uma aplicação com o nome predefinido "<organization name> App" e sem URLs públicos configurados.

Todos os campos são opcionais. Enviar um corpo vazio cria uma aplicação com um nome predefinido, na União Europeia.

name
string

Nome de apresentação da aplicação. O valor predefinido é "<organization name> App".

Exemplo:

"Acme Customer App"

website_url
string

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

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

Exemplo:

"https://acme.example/terms"

privacy_url
string

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

Exemplo:

"https://acme.example/privacy"

description
string

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

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 criada. A resposta inclui a api_key de longa duração; guarde-a agora e use-a como cabeçalho x-api-key em cada chamada a https://verification.didit.me/v3/....

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