Skip to content
Navigation

Crear sesión de verificación

POST
https://test-api-sovra.flagonsa.com/api/v1/verifier/verifications

Inicia una sesión de verificación OID4VP. dcql_query sigue la especificación DCQL de OID4VP.

Tres reglas que evitan casi todos los fallos:

  1. Cada path debe coincidir carácter por carácter con el key del esquema.
  2. Todos los claims pedidos son obligatorios: si el holder omite uno, falla toda la presentación.
  3. id es una etiqueta libre tuya, devuelta tal cual en el resultado; no filtra por tipo de credencial.

La respuesta trae session_id, authorization_request_uri (autocontenida) y authorization_request_uri_ref (corta, para DCQL grandes). La sesión vive 10 minutos.

Authorization

  • apiKey
    HTTP Bearer
    required

    Authorization: Bearer <token>

Request body JSON required

  • dcql_query
    optional
    object
    • credentials
      optional
      array of
      object
      • id
        optional
        string
      • format
        optional
        string
      • claims
        optional
        array of
        object
        • path
          optional
          array of
          string

Example requests

{
  "dcql_query": {
    "credentials": [
      {
        "id": "identidad",
        "format": "vc+sd-jwt",
        "claims": [
          {
            "path": [
              "email"
            ]
          }
        ]
      }
    ]
  }
}

Returns

200

Respuesta exitosa. La colección de Postman de origen no incluye el cuerpo de la respuesta; ver la guía de referencia.

Type to search…

↑↓ navigate↵ selectEsc close