Saltar al contingut principal
POST
cURL
Utilitza aquest endpoint quan necessitis separar el trànsit de verificació, les credencials, la marca o els informes dins de la mateixa organització. Això és especialment útil per als revenedors que creen una aplicació per cada client. També va molt bé quan la teva empresa té diversos productes, marques, regions, entorns de proves/producció o casos d’ús que no han de compartir la mateixa clau d’API ni la configuració a nivell d’aplicació.
Tots els endpoints de l’API d’autenticació utilitzen https://apx.didit.me/auth/v2. Utilitza el api_key retornat com a x-api-key quan cridis els endpoints de https://verification.didit.me/v3/..., com les sessions i els fluxos de treball.

Ubicació de les dades

Cada aplicació emmagatzema i processa les seves dades de verificació en una única ubicació, la seva ubicació de les dades, que es tria en crear-la amb data_location. Avui l’única ubicació disponible és eu, la Unió Europea (Irlanda), que també és la predeterminada si omets el camp. Austràlia (Sydney, au) i Mèxic (mx) estan previstes properament: una sol·licitud que les indiqui respon amb 400 This data location is not available yet. i no crea res. Cada lectura de l’aplicació retorna el seu data_location, i no es pot canviar després de crear-la. Consulta Ubicació de les dades.

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ó. Consulta'l amb GET /organizations/me/.

Exemple:

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

Cos

application/json

Tots els camps són opcionals. Ometre el cos crea una aplicació amb el nom per defecte "<organization name> App" i sense URL públiques configurades.

Tots els camps són opcionals. Enviar un cos buit crea una aplicació amb un nom per defecte, a la Unió Europea.

name
string

Nom visible de l'aplicació. Per defecte és "<organization name> App".

Exemple:

"Acme Customer App"

website_url
string

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

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

Exemple:

"https://acme.example/terms"

privacy_url
string

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

Exemple:

"https://acme.example/privacy"

description
string

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

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ó creada. La resposta inclou la api_key de llarga durada; desa-la ara i fes-la servir com a capçalera x-api-key a cada crida a https://verification.didit.me/v3/....

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