Pular para o conteúdo principal
PATCH
cURL
Use este endpoint para manter cada aplicação alinhada ao cliente, à marca, ao ambiente ou ao caso de uso interno que ela representa. Para revendedores, isso permite renomear ou atualizar a aplicação de cada cliente sem compartilhar credenciais entre clientes. Para clientes diretos, ajuda a separar produtos, regiões ou ambientes, mantendo tudo em uma única organização.
Este endpoint atualiza os metadados da aplicação. A api_key continua a mesma, a menos que você faça a rotação das credenciais separadamente.

Autorizações

Authorization
string
header
obrigatório

JWT access_token assinado com RS256, retornado por POST /programmatic/login/ ou POST /programmatic/verify-email/. Envie como Authorization: Bearer <access_token>. A validade padrão é de 86400 segundos (24h). Este token só é válido nos endpoints de Account Management em apx.didit.me/auth/v2. A API de verificação (verification.didit.me/v3) usa, 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 proprietária da aplicação.

Exemplo:

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

app_id
string<uuid>
obrigatório

UUID da aplicação a ser atualizada.

Exemplo:

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

Corpo

application/json

Envie apenas os campos que você quer alterar. Semântica de PATCH: os campos ausentes são preservados.

Corpo do PATCH para os metadados da aplicação. Envie apenas os campos que deseja alterar; os campos omitidos são preservados. uuid, client_id e api_key não podem ser atualizados. products é somente leitura: uma chave products no corpo é ignorada.

name
string

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

Exemplo:

"Acme Production App"

website_url
string

URL do site ou do app associado a esta aplicação.

Exemplo:

"https://app.acme.example"

redirect_uris
string[]

URIs de redirecionamento permitidas para fluxos de redirecionamento no estilo OAuth e de verificação.

Exemplo:
terms_url
string

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

privacy_url
string

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

description
string

Descrição interna da aplicação.

Resposta

Aplicação atualizada. A resposta é o registro completo da aplicação após a alteração, incluindo products. uuid, client_id e api_key permanecem inalterados.

Registro completo da aplicação. uuid, client_id e api_key nunca mudam após a criação.

uuid
string<uuid>

UUID da aplicação. Use como {app_id} nas chamadas seguintes.

Exemplo:

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

name
string

Nome de exibição da aplicação mostrado no console da Didit.

Exemplo:

"Acme Production App"

client_id
string

Identificador público do cliente, seguro para incorporar em fluxos no estilo OAuth.

Exemplo:

"S9LIYGSoWNuGMLHsvEt9dQ"

api_key
string

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

Exemplo:

"sk_live_example_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

website_url
string | null

URL do site ou do app associado a esta aplicação.

Exemplo:

"https://acme.example"

redirect_uris
string[]

URIs de redirecionamento permitidas para fluxos de redirecionamento no estilo OAuth e de verificação.

Exemplo:
terms_url
string | null

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

Exemplo:

"https://acme.example/terms"

privacy_url
string | null

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

Exemplo:

"https://acme.example/privacy"

description
string | null

Descrição interna da aplicação (não exibida aos usuários finais).

created_at
string<date-time>
Exemplo:

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

products
object[]
read-only

Os produtos da aplicação. Sempre os três, nesta ordem: identity, transactions, authentication. Uma nova aplicação tem identity habilitado com todos os módulos ativos, e transactions e authentication desabilitados. Somente leitura: uma chave products no corpo de criação ou atualização é ignorada.

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