Saltar al contenido principal
POST
cURL
Usa este endpoint cuando necesites separar el tráfico de verificación, las credenciales, la marca o los informes dentro de una misma organización. Resulta especialmente útil para los revendedores que crean una aplicación por cliente. También funciona bien cuando tu propia empresa tiene varios productos, marcas, regiones, entornos de staging y producción o casos de uso que no deben compartir la misma clave de API ni la misma configuración a nivel de aplicación.
Todos los endpoints de la Auth API usan https://apx.didit.me/auth/v2. Usa el api_key devuelto como x-api-key al invocar los endpoints de https://verification.didit.me/v3/..., como los de sesiones y flujos.

Autorizaciones

Authorization
string
header
requerido

JWT access_token firmado con RS256 que devuelve POST /programmatic/login/ o POST /programmatic/verify-email/. Envíalo como Authorization: Bearer <access_token>. La vida útil predeterminada es de 86400 segundos (24 h). Este token solo es válido para los endpoints de gestión de cuentas en apx.didit.me/auth/v2. La API de verificación (verification.didit.me/v3) usa en su lugar la api_key de larga duración como x-api-key.

Parámetros de ruta

org_id
string<uuid>
requerido

UUID de la organización. Consúltalo con GET /organizations/me/.

Ejemplo:

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

Cuerpo

application/json

Todos los campos son opcionales. Si omites el cuerpo, se crea una aplicación con el nombre predeterminado "<organization name> App" y sin URL públicas configuradas.

Todos los campos son opcionales. Si envías un cuerpo vacío, se crea una aplicación con un nombre predeterminado.

name
string

Nombre visible de la aplicación. Valor predeterminado: "<organization name> App".

Ejemplo:

"Acme Customer App"

website_url
string

URL del sitio web o de la app asociada a esta aplicación.

Ejemplo:

"https://acme.example"

redirect_uris
string[]

URI de redirección permitidas para los flujos de redirección de tipo OAuth y de verificación.

Ejemplo:
terms_url
string

URL de los términos del servicio que se muestra en el flujo de verificación.

Ejemplo:

"https://acme.example/terms"

privacy_url
string

URL de la política de privacidad que se muestra en el flujo de verificación.

Ejemplo:

"https://acme.example/privacy"

description
string

Descripción interna de la aplicación (no se muestra a los usuarios finales).

Respuesta

Aplicación creada. La respuesta incluye la api_key de larga duración; guárdala ahora y úsala como encabezado x-api-key en cada llamada a https://verification.didit.me/v3/....

Registro completo de la aplicación. uuid, client_id y api_key nunca cambian después de la creación.

uuid
string<uuid>

UUID de la aplicación. Úsalo como {app_id} en las llamadas posteriores.

Ejemplo:

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

name
string

Nombre visible de la aplicación que se muestra en la consola de Didit.

Ejemplo:

"Acme Production App"

client_id
string

Identificador público del cliente, seguro para incrustarlo en flujos de tipo OAuth.

Ejemplo:

"S9LIYGSoWNuGMLHsvEt9dQ"

api_key
string

Secreto de larga duración (también llamado client_secret). Úsalo como encabezado x-api-key en todas las llamadas a https://verification.didit.me/v3/... (sesiones, flujos, AML, etc.). Trátalo como una credencial; nunca lo expongas en el lado del cliente. Las claves nuevas empiezan por sk_live_ (aplicación de producción) o sk_test_ (aplicación de sandbox), seguidas de 43 caracteres seguros para URL (letras, dígitos, - y _). Las claves creadas antes de este formato no tienen prefijo y siguen funcionando sin cambios. Durante las 72 horas posteriores a la recuperación de tu cuenta, las operaciones de listar, obtener y actualizar devuelven aquí una cadena vacía en lugar de la clave.

Ejemplo:

"sk_live_example_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

website_url
string | null

URL del sitio web o de la app asociada a esta aplicación.

Ejemplo:

"https://acme.example"

redirect_uris
string[]

URI de redirección permitidas para los flujos de redirección de tipo OAuth y de verificación.

Ejemplo:
terms_url
string | null

URL de los términos del servicio que se muestra en el flujo de verificación.

Ejemplo:

"https://acme.example/terms"

privacy_url
string | null

URL de la política de privacidad que se muestra en el flujo de verificación.

Ejemplo:

"https://acme.example/privacy"

description
string | null

Descripción interna de la aplicación (no se muestra a los usuarios finales).

created_at
string<date-time>
Ejemplo:

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

products
object[]
read-only

Los productos de la aplicación. Siempre los tres, en este orden: identity, transactions, authentication. Una aplicación nueva tiene identity habilitado con todos los módulos activados, y transactions y authentication deshabilitados. Solo lectura: una clave products en el cuerpo de una creación o actualización se ignora.

Ejemplo:
Última modificación el 1 de noviembre de 2026