API para obtener credenciales: client_id y api_key

cURL

curl "https://apx.didit.me/auth/v2/organizations/me/$ORG_ID/applications/$APP_ID/" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

from didit import Didit

# Use the access token that account.login returns.
client = Didit(account_token="YOUR_ACCESS_TOKEN")

result = client.account.applications.retrieve(
    "a1b2c3d4-5678-90ab-cdef-111111111111",
    "b2c3d4e5-6789-01bc-defg-222222222222",
)
print(result)

import Didit from "@didit-protocol/sdk-node";

// Use the access token that account.login returns.
const didit = new Didit({ accountToken: "YOUR_ACCESS_TOKEN" });

const result = await didit.account.applications.retrieve(
  "a1b2c3d4-5678-90ab-cdef-111111111111",
  "b2c3d4e5-6789-01bc-defg-222222222222",
);
console.log(result);

ctx := context.Background()
// Use the access token that account.login returns.
client := didit.NewClient(option.WithAccountToken("YOUR_ACCESS_TOKEN"))

result, err := client.Account.Applications.Retrieve(ctx, "a1b2c3d4-5678-90ab-cdef-111111111111", "b2c3d4e5-6789-01bc-defg-222222222222")
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%+v\n", result)

import me.didit.Didit;

// Use the access token that account.login returns.
Didit client = Didit.builder().accountToken("YOUR_ACCESS_TOKEN").build();

var result = client.account().applications().retrieve("a1b2c3d4-5678-90ab-cdef-111111111111", "b2c3d4e5-6789-01bc-defg-222222222222");
System.out.println(result);

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Use the access token that account.login returns.
$didit = new DiditClient(accountToken: 'YOUR_ACCESS_TOKEN');

$result = $didit->account->applications->retrieve('a1b2c3d4-5678-90ab-cdef-111111111111', 'b2c3d4e5-6789-01bc-defg-222222222222');
print_r($result->toArray());

require "didit"

# Use the access token that account.login returns.
didit = Didit::Client.new(account_token: "YOUR_ACCESS_TOKEN")

result = didit.account.applications.retrieve(
  "a1b2c3d4-5678-90ab-cdef-111111111111",
  "b2c3d4e5-6789-01bc-defg-222222222222"
)
puts result.to_h

using System;
using System.Text.Json;
using Didit;

// Use the access token that account.login returns.
using var client = new DiditClient(new DiditClientOptions { AccountToken = "YOUR_ACCESS_TOKEN" });

var result = await client.Account.Applications.RetrieveAsync("a1b2c3d4-5678-90ab-cdef-111111111111", "b2c3d4e5-6789-01bc-defg-222222222222");
Console.WriteLine(JsonSerializer.Serialize(result));

{
  "uuid": "b2c3d4e5-6789-01bc-defg-222222222222",
  "name": "My App",
  "client_id": "S9LIYGSoWNuGMLHsvEt9dQ",
  "api_key": "sk_live_example_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "website_url": "https://example.com",
  "redirect_uris": [
    "https://example.com/callback"
  ],
  "terms_url": "https://example.com/terms",
  "privacy_url": "https://example.com/privacy",
  "description": "Production application",
  "created_at": "2025-06-01T10:00:00Z",
  "products": [
    {
      "product": "identity",
      "status": "enabled",
      "modules": {
        "user_verification": true,
        "business_verification": true,
        "case_management": true
      }
    },
    {
      "product": "transactions",
      "status": "disabled",
      "modules": {
        "travel_rule": true,
        "case_management": true
      }
    },
    {
      "product": "authentication",
      "status": "disabled",
      "modules": {}
    }
  ]
}

GET

organizations

{org_id}

applications

{app_id}

cURL

curl "https://apx.didit.me/auth/v2/organizations/me/$ORG_ID/applications/$APP_ID/" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

from didit import Didit

# Use the access token that account.login returns.
client = Didit(account_token="YOUR_ACCESS_TOKEN")

result = client.account.applications.retrieve(
    "a1b2c3d4-5678-90ab-cdef-111111111111",
    "b2c3d4e5-6789-01bc-defg-222222222222",
)
print(result)

import Didit from "@didit-protocol/sdk-node";

// Use the access token that account.login returns.
const didit = new Didit({ accountToken: "YOUR_ACCESS_TOKEN" });

const result = await didit.account.applications.retrieve(
  "a1b2c3d4-5678-90ab-cdef-111111111111",
  "b2c3d4e5-6789-01bc-defg-222222222222",
);
console.log(result);

ctx := context.Background()
// Use the access token that account.login returns.
client := didit.NewClient(option.WithAccountToken("YOUR_ACCESS_TOKEN"))

result, err := client.Account.Applications.Retrieve(ctx, "a1b2c3d4-5678-90ab-cdef-111111111111", "b2c3d4e5-6789-01bc-defg-222222222222")
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%+v\n", result)

import me.didit.Didit;

// Use the access token that account.login returns.
Didit client = Didit.builder().accountToken("YOUR_ACCESS_TOKEN").build();

var result = client.account().applications().retrieve("a1b2c3d4-5678-90ab-cdef-111111111111", "b2c3d4e5-6789-01bc-defg-222222222222");
System.out.println(result);

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Use the access token that account.login returns.
$didit = new DiditClient(accountToken: 'YOUR_ACCESS_TOKEN');

$result = $didit->account->applications->retrieve('a1b2c3d4-5678-90ab-cdef-111111111111', 'b2c3d4e5-6789-01bc-defg-222222222222');
print_r($result->toArray());

require "didit"

# Use the access token that account.login returns.
didit = Didit::Client.new(account_token: "YOUR_ACCESS_TOKEN")

result = didit.account.applications.retrieve(
  "a1b2c3d4-5678-90ab-cdef-111111111111",
  "b2c3d4e5-6789-01bc-defg-222222222222"
)
puts result.to_h

using System;
using System.Text.Json;
using Didit;

// Use the access token that account.login returns.
using var client = new DiditClient(new DiditClientOptions { AccountToken = "YOUR_ACCESS_TOKEN" });

var result = await client.Account.Applications.RetrieveAsync("a1b2c3d4-5678-90ab-cdef-111111111111", "b2c3d4e5-6789-01bc-defg-222222222222");
Console.WriteLine(JsonSerializer.Serialize(result));

{
  "uuid": "b2c3d4e5-6789-01bc-defg-222222222222",
  "name": "My App",
  "client_id": "S9LIYGSoWNuGMLHsvEt9dQ",
  "api_key": "sk_live_example_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "website_url": "https://example.com",
  "redirect_uris": [
    "https://example.com/callback"
  ],
  "terms_url": "https://example.com/terms",
  "privacy_url": "https://example.com/privacy",
  "description": "Production application",
  "created_at": "2025-06-01T10:00:00Z",
  "products": [
    {
      "product": "identity",
      "status": "enabled",
      "modules": {
        "user_verification": true,
        "business_verification": true,
        "case_management": true
      }
    },
    {
      "product": "transactions",
      "status": "disabled",
      "modules": {
        "travel_rule": true,
        "case_management": true
      }
    },
    {
      "product": "authentication",
      "status": "disabled",
      "modules": {}
    }
  ]
}

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 propietaria de la aplicación.

Ejemplo:

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

app_id

string<uuid>

requerido

UUID de la aplicación cuyas credenciales quieres leer.

Ejemplo:

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

Respuesta

Registro de la aplicación, con su client_id y su api_key.

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:

["https://acme.example/callback"]

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.

Show child attributes

Ejemplo:

[
  {
    "product": "identity",
    "status": "enabled",
    "modules": {
      "user_verification": true,
      "business_verification": true,
      "case_management": true
    }
  },
  {
    "product": "transactions",
    "status": "disabled",
    "modules": {
      "travel_rule": true,
      "case_management": true
    }
  },
  {
    "product": "authentication",
    "status": "disabled",
    "modules": {}
  }
]

Última modificación el 1 de noviembre de 2026