Saltar al contingut principal
GET
cURL

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ó les credencials de la qual vols llegir.

Exemple:

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

Resposta

Registre de l'aplicació que inclou el seu client_id i api_key.

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