Identifiers

Endpoints de solo lectura para consultar el registro de DIDs.

Listar DIDs

GET /api/v1/identifiers

Devuelve la lista paginada de todos los DIDs registrados en el entorno.

Parámetros

Nombre	En	Tipo	Default	Descripción
page	query	integer ≥ 1	1	Número de página.
pageSize	query	integer ≥ 1	10	Número de elementos por página.

Respuesta 200 OK

{
  "page": 1,
  "pageSize": 50,
  "total": 1234,
  "howMany": 50,
  "items": [
    "did:isbe:uc:z12kVar5p6bD5WCjEJcQ18Zyt8XV",
    "did:isbe:uc:z2ABCdef..."
  ]
}

Campo	Tipo	Descripción
page	integer	Página devuelta.
pageSize	integer	Tamaño de página solicitado.
total	integer	Total de DIDs en el registro.
howMany	integer	Número real de items devueltos en esta página.
items	array<string>	Lista de DIDs.

Ejemplo

curl "https://did-registry.portal.redisbe.com/api/v1/identifiers?page=2&pageSize=100"

Resolver DID

GET /api/v1/identifiers/{identifier}

Devuelve el DID Document asociado a un DID, opcionalmente en un instante temporal específico.

Parámetros

Nombre	En	Tipo	Required	Descripción
identifier	path	string	sí	DID completo. URL-encode si contiene caracteres reservados.
valid-at	query	number	no	Timestamp Unix en segundos. Devuelve el estado del documento en ese instante.

Headers

• Accept: application/did+ld+json (recomendado, JSON-LD)
• Accept: application/did+json (JSON plano)

Respuesta 200 OK

DID Document con el formato W3C:

{
  "@context": [
    "https://www.w3.org/ns/did/v1",
    "https://w3id.org/security/suites/jws-2020/v1"
  ],
  "id": "did:isbe:uc:z12kVar5p6bD5WCjEJcQ18Zyt8XV",
  "controller": ["0xAe0E493C67f75381b0954644836A3C16c79D0dFD"],
  "verificationMethod": [
    {
      "id": "did:isbe:uc:z12kVar5p6bD5WCjEJcQ18Zyt8XV#9lfZ28jdUsYo75lVHmGNIc6oUpkjSFtxiCLjDGn28IM",
      "type": "JsonWebKey2020",
      "controller": "did:isbe:uc:z12kVar5p6bD5WCjEJcQ18Zyt8XV",
      "publicKeyJwk": {
        "kty": "EC",
        "crv": "secp256k1",
        "x": "EkP1CscPyZbMySohGc5ktvcLv0yh/Tsl/Fyk/T6jUlsK",
        "y": "FD4PfiOzITnM4zo9IgfvkN7DC4VxRSB4f-PKcTfcMyE"
      }
    }
  ],
  "assertionMethod": ["did:isbe:uc:z12kVar5p6bD5WCjEJcQ18Zyt8XV#..."],
  "alsoKnownAs": ["urn:oid:organizationIdentifier:ISBE"]
}

Tipo y formato del material criptográfico

Todos los verification methods se devuelven con type: "JsonWebKey2020" y la clave en publicKeyJwk, independientemente de la curva. La curva real (secp256k1, P-256) está en el campo crv dentro del JWK.

Códigos de error

Código	Causa
400	Identifier mal formado o valid-at no numérico.
404	El DID no existe.
406	Accept no soportado.

Ejemplos

# Resolución actual
curl -H "Accept: application/did+ld+json" \
  "https://did-registry.portal.redisbe.com/api/v1/identifiers/did:isbe:uc:z12kVar5p6bD5WCjEJcQ18Zyt8XV"

# Resolución histórica
curl -H "Accept: application/did+ld+json" \
  "https://did-registry.portal.redisbe.com/api/v1/identifiers/did:isbe:uc:z12kVar5p6bD5WCjEJcQ18Zyt8XV?valid-at=1742000000"

Para más detalle sobre casos de uso de la resolución, ver Resolución de DIDs.