Saltar al contingut principal
PATCH
cURL
Utilitza aquest endpoint per mantenir cada aplicació alineada amb el client, la marca, l’entorn o el cas d’ús intern que representa. Per als revenedors, això et permet canviar el nom o actualitzar cada aplicació de client sense compartir credencials entre clients. Per als clients directes, ajuda a separar productes, regions o entorns i alhora mantenir-ho tot dins d’una mateixa organització.
Aquest endpoint actualitza les metadades de l’aplicació. La api_key es manté igual, tret que rotis les credencials per separat.

Ubicació de les dades

La ubicació de les dades de l’aplicació (data_location) es tria quan es crea l’aplicació i no es pot canviar després: una actualització que indica la ubicació que l’aplicació ja té s’accepta, i qualsevol altra ubicació retorna 400. L’excepció és l’aplicació de producció creada juntament amb la teva organització, en el moment del registre o mitjançant Verificació de correu electrònic. La primera actualització que indica un data_location en tria la ubicació, una sola vegada, sempre que cap de les claus d’API de l’aplicació s’hagi fet servir i l’aplicació no tingui cap sessió de verificació. El pas Posa nom a la teva primera aplicació de la consola fa servir això per emmagatzemar la ubicació que hi triïs. Avui l’única ubicació disponible és eu, la Unió Europea (Irlanda).

Autoritzacions

Authorization
string
header
requerit

access_token JWT signat amb RS256 retornat per POST /programmatic/login/ o POST /programmatic/verify-email/. Envia'l com a Authorization: Bearer <access_token>. La durada per defecte és de 86400 segons (24 h). Aquest token només és vàlid per als endpoints de gestió de comptes a apx.didit.me/auth/v2. L'API de verificació (verification.didit.me/v3) utilitza en el seu lloc la api_key de llarga durada com a x-api-key.

Paràmetres de ruta

org_id
string<uuid>
requerit

UUID de l'organització propietària de l'aplicació.

Exemple:

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

app_id
string<uuid>
requerit

UUID de l'aplicació que cal actualitzar.

Exemple:

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

Cos

application/json

Envia només els camps que vulguis canviar. Semàntica de PATCH: es conserven els camps que no s'incloguin.

Cos del PATCH per a les metadades de l'aplicació. Envia només els camps que vulguis modificar; els camps omesos es conserven. uuid, client_id i api_key no es poden actualitzar. products és només de lectura: s'ignora qualsevol clau products al cos. data_location no es pot modificar després de crear l'aplicació: indicar la ubicació que ja té és acceptat, i qualsevol altra ubicació respon 400. L'única excepció és l'aplicació de producció creada amb la teva organització: la primera actualització que indiqui una data_location la tria, una sola vegada, sempre que no s'hagi utilitzat cap clau d'API de l'aplicació i que no tingui cap sessió de verificació.

name
string

Nom visible de l'aplicació.

Exemple:

"Acme Production App"

website_url
string

URL del lloc web o de l'aplicació associada a aquesta aplicació.

Exemple:

"https://app.acme.example"

redirect_uris
string[]

URI de redirecció permeses per a fluxos de redirecció de verificació i d'estil OAuth.

Exemple:
terms_url
string

URL de les condicions del servei que es mostra al flux de verificació.

privacy_url
string

URL de la política de privadesa que es mostra al flux de verificació.

description
string

Descripció interna de l'aplicació.

data_location
enum<string>

On s'emmagatzemen i es processen les dades de verificació de l'aplicació, que se selecciona en crear l'aplicació. eu és la Unió Europea (Irlanda), l'opció per defecte. au (Austràlia, Sydney) i mx (Mèxic) estaran disponibles properament: una sol·licitud que els indiqui respon 400 This data location is not available yet. L'aplicació de sandbox d'una organització sempre és a la Unió Europea.

Opcions disponibles:
eu,
au,
mx
Exemple:

"eu"

Resposta

Aplicació actualitzada. La resposta és el registre complet de l'aplicació després del canvi, inclòs products; uuid, client_id i api_key no canvien.

Registre complet de l'aplicació. uuid, client_id i api_key no canvien mai després de la creació. data_location tampoc no canvia, excepte un sol cop a l'aplicació de producció creada amb la teva organització, abans d'utilitzar-la (consulta la sol·licitud d'actualització).

uuid
string<uuid>

UUID de l'aplicació. Utilitza'l com a {app_id} en les crides posteriors.

Exemple:

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

name
string

Nom visible de l'aplicació que es mostra a la consola de Didit.

Exemple:

"Acme Production App"

client_id
string

Identificador públic de client, segur per incrustar en fluxos d'estil OAuth.

Exemple:

"S9LIYGSoWNuGMLHsvEt9dQ"

api_key
string

Secret de llarga durada (també anomenat client_secret). Utilitza'l com a capçalera x-api-key per a cada crida a https://verification.didit.me/v3/... (sessions, fluxos de treball, AML, etc.). Tracta'l com una credencial; no l'exposis mai al costat del client. Les claus noves comencen amb sk_live_ (aplicació de producció) o sk_test_ (aplicació de sandbox), seguits de 43 caràcters segurs per a URL (lletres, dígits, - i _). Les claus creades abans d'aquest format no tenen prefix i continuen funcionant sense canvis. Durant les 72 hores posteriors a la recuperació del teu compte, les operacions de llistar, consultar i actualitzar retornen una cadena buida aquí en lloc de la clau.

Exemple:

"sk_live_example_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

website_url
string | null

URL del lloc web o de l'aplicació associada a aquesta aplicació.

Exemple:

"https://acme.example"

redirect_uris
string[]

URI de redirecció permeses per a fluxos de redirecció de verificació i d'estil OAuth.

Exemple:
terms_url
string | null

URL de les condicions del servei que es mostra al flux de verificació.

Exemple:

"https://acme.example/terms"

privacy_url
string | null

URL de la política de privadesa que es mostra al flux de verificació.

Exemple:

"https://acme.example/privacy"

description
string | null

Descripció interna de l'aplicació (no es mostra als usuaris finals).

created_at
string<date-time>
Exemple:

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

data_location
enum<string>

On s'emmagatzemen i es processen les dades de verificació de l'aplicació, que se selecciona en crear l'aplicació. eu és la Unió Europea (Irlanda), l'opció per defecte. au (Austràlia, Sydney) i mx (Mèxic) estaran disponibles properament: una sol·licitud que els indiqui respon 400 This data location is not available yet. L'aplicació de sandbox d'una organització sempre és a la Unió Europea.

Opcions disponibles:
eu,
au,
mx
Exemple:

"eu"

products
object[]
read-only

Els productes de l'aplicació. Sempre tots tres, en aquest ordre: identity, transactions, authentication. Una nova aplicació té identity habilitat amb tots els mòduls activats, i transactions i authentication inhabilitats. Només lectura: s'ignora la clau products en un cos de creació o actualització.

Exemple:
Darrera modificació el 7 de novembre del 2026