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:
- Cada
pathdebe coincidir carácter por carácter con elkeydel esquema. - Todos los claims pedidos son obligatorios: si el holder omite uno, falla toda la presentación.
ides 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
Request body JSON required
Example requests
{
"dcql_query": {
"credentials": [
{
"id": "identidad",
"format": "vc+sd-jwt",
"claims": [
{
"path": [
"email"
]
}
]
}
]
}
}{
"dcql_query": {
"credentials": [
{
"id": "licencia",
"format": "mso_mdoc",
"meta": {
"doctype_value": "io.sovra.0x5de0df12cce712ddaaa23feb359920ae4f3230d4.driving_licence_v2.1"
},
"claims": [
{
"path": [
"mx.gob.nl.icv.1",
"given_name"
]
},
{
"path": [
"mx.gob.nl.icv.1",
"family_name"
]
},
{
"path": [
"mx.gob.nl.icv.1",
"second_family_name"
]
},
{
"path": [
"mx.gob.nl.icv.1",
"document_number"
]
},
{
"path": [
"mx.gob.nl.icv.1",
"expiry_date"
]
},
{
"path": [
"mx.gob.nl.icv.1",
"driving_privileges"
]
},
{
"path": [
"mx.gob.nl.icv.1",
"portrait"
]
}
]
}
]
}
}{
"dcql_query": {
"credentials": [
{
"id": "edad",
"format": "mso_mdoc",
"meta": {
"doctype_value": "io.sovra.0x5de0df12cce712ddaaa23feb359920ae4f3230d4.driving_licence_v2.1"
},
"claims": [
{
"path": [
"mx.gob.nl.icv.1",
"age_over_18"
]
}
]
}
]
}
}{
"dcql_query": {
"credentials": [
{
"id": "urgencias",
"format": "mso_mdoc",
"meta": {
"doctype_value": "io.sovra.0x5de0df12cce712ddaaa23feb359920ae4f3230d4.driving_licence_v2.1"
},
"claims": [
{
"path": [
"mx.gob.nl.icv.1",
"blood_type"
]
},
{
"path": [
"mx.gob.nl.icv.1",
"allergies"
]
},
{
"path": [
"mx.gob.nl.icv.1",
"organ_donor"
]
},
{
"path": [
"mx.gob.nl.icv.1",
"emergency_phone"
]
}
]
}
]
}
}{
"dcql_query": {
"credentials": [
{
"id": "domicilio",
"format": "mso_mdoc",
"meta": {
"doctype_value": "io.sovra.0x5de0df12cce712ddaaa23feb359920ae4f3230d4.driving_licence_v2.1"
},
"claims": [
{
"path": [
"mx.gob.nl.icv.1",
"street"
]
},
{
"path": [
"mx.gob.nl.icv.1",
"exterior_number"
]
},
{
"path": [
"mx.gob.nl.icv.1",
"interior_number"
]
},
{
"path": [
"mx.gob.nl.icv.1",
"neighborhood"
]
},
{
"path": [
"mx.gob.nl.icv.1",
"resident_city"
]
},
{
"path": [
"mx.gob.nl.icv.1",
"resident_postal_code"
]
}
]
}
]
}
}{
"dcql_query": {
"credentials": [
{
"id": "cobertura",
"format": "mso_mdoc",
"meta": {
"doctype_value": "io.sovra.0x5de0df12cce712ddaaa23feb359920ae4f3230d4.driving_licence_v2.1"
},
"claims": [
{
"path": [
"mx.gob.nl.icv.1",
"street"
]
},
{
"path": [
"mx.gob.nl.icv.1",
"resident_postal_code"
]
}
]
}
]
}
}{
"dcql_query": {
"credentials": [
{
"id": "tramite",
"format": "mso_mdoc",
"meta": {
"doctype_value": "io.sovra.0x5de0df12cce712ddaaa23feb359920ae4f3230d4.driving_licence_v2.1"
},
"claims": [
{
"path": [
"mx.gob.nl.icv.1",
"curp"
]
},
{
"path": [
"mx.gob.nl.icv.1",
"given_name"
]
},
{
"path": [
"mx.gob.nl.icv.1",
"family_name"
]
},
{
"path": [
"mx.gob.nl.icv.1",
"second_family_name"
]
}
]
}
]
}
}Returns
200
Respuesta exitosa. La colección de Postman de origen no incluye el cuerpo de la respuesta; ver la guía de referencia.