Redactar una sesión

Borra de inmediato todo sobre la persona de una sesión que ya terminó: las fotos, lo que se leyó de la identificación, los datos de `expected`, y tu `reference`, `metadata` y `return_url`. El estado, los motivos y las revisiones se quedan como tu registro. No se puede deshacer. Redactar una sesión dos veces no cambia nada.

POST

/v1/verify/sessions/{id}/redact

Borra de inmediato todo sobre la persona de una sesión que ya terminó: las fotos, lo que se leyó de la identificación, los datos de expected, y tu reference, metadata y return_url. El estado, los motivos y las revisiones se quedan como tu registro. No se puede deshacer. Redactar una sesión dos veces no cambia nada.

Autorización

apiKey

headerAutorizaciónBearer <token>

Tu clave de API, que empieza con upsky_test_ o upsky_live_.

Parámetros de ruta

id*string

Formatouuid

Cuerpo de la respuesta

La sesión redactada.

application/json

response

id*string

Formatouuid

object*"verify.session"

Valor en"verify.session"

livemode*boolean

tier*string

Valor en"age""identity""identity_plus"

status*string

pending until the person opens the link, in_progress while they take photos, processing once submitted, then approved, rejected or needs_review. A link that's never finished ends expired or canceled, and isn't charged.

Valor en"pending""in_progress""processing""approved""rejected""needs_review""expired""canceled"

url*|

The link to send the person to. Null once it can't be used anymore.

reference*string|null

metadata*

project_id*|

Formatouuid

return_url*string|null

minimum_age*integer

allow_selfie_upload*boolean

Whether the person may send a selfie from their photos. When false, it has to be taken with the camera on the page.

show_result*boolean

Si el enlace muestra a la persona el resultado una vez decidido.

thresholds*

Qué tan segura debía estar cada revisión, copiado al crear la sesión de la configuración de Verify de su proyecto, o de la de tu equipo si el proyecto no tiene. Una puntuación igual o mayor que la marca de aprobación pasa; desde la marca de revisión hasta la de aprobación va a revisión; por debajo de la marca de revisión se rechaza.

options*

Con qué opciones corre la sesión, copiadas al crearla de la configuración de Verify de su proyecto, o de tu equipo, más lo que hayas indicado en la solicitud.

reasons*array<>

Why the session ended as it did.

checks*

What each check found. Empty until the session is decided.

document_type*|

Valor en"mx_ine""passport""us_drivers_license""id_card"null

verified_outputs*|

What was read from the ID. Identity tier and above, once decided. Only returned when you read one session, never in lists or webhooks.

expires_at*string

created_at*string

started_at*string|null

submitted_at*string|null

decided_at*string|null

reviewed_at*string|null

redacted_at*|

Cuándo se borraron los datos de la persona de la sesión con el endpoint de redacción.

Ejemplo de solicitud

curl -X POST 'https://api.upsky.dev/v1/verify/sessions/497f6eca-6276-4993-bfeb-53cbbbba6f08/redact'

Ejemplo de solicitud

curl -X POST 'https://api.upsky.dev/v1/verify/sessions/497f6eca-6276-4993-bfeb-53cbbbba6f08/redact'

Ejemplo de respuestaEsquema

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "object": "verify.session",
  "livemode": true,
  "tier": "age",
  "status": "pending",
  "url": "string",
  "reference": "string",
  "metadata": {
    "property1": "string",
    "property2": "string"
  },
  "project_id": "405d8375-3514-403b-8c43-83ae74cfe0e9",
  "return_url": "string",
  "minimum_age": 0,
  "allow_selfie_upload": true,
  "show_result": true,
  "thresholds": {
    "preset": "relaxed",
    "liveness_pass": 0,
    "liveness_review": 0,
    "face_match_pass": 0,
    "face_match_review": 0,
    "age_buffer_years": 0
  },
  "options": {
    "documents": {
      "allowed_types": [
        "mx_ine"
      ],
      "allowed_countries": [
        "string"
      ],
      "max_attempts": 0
    },
    "rules": {
      "liveness_inconclusive": "reject",
      "age_inconclusive": "reject",
      "document_unreadable": "reject",
      "document_expired": "reject",
      "document_checksum_failed": "reject",
      "document_type_mismatch": "reject",
      "document_country_not_accepted": "reject",
      "date_of_birth_missing": "reject",
      "face_match_inconclusive": "reject",
      "age_estimate_mismatch": "reject",
      "name_mismatch": "reject",
      "date_of_birth_mismatch": "reject"
    },
    "retention_days": 0
  },
  "reasons": [
    "liveness_failed"
  ],
  "checks": {
    "liveness": {
      "status": "passed",
      "confidence": 0,
      "feedback": [
        "face_not_visible"
      ]
    },
    "age": {
      "status": "passed",
      "minimum_age": 0,
      "estimated_low": 0,
      "estimated_high": 0,
      "estimated_age": 0,
      "age_from_document": 0
    },
    "document": {
      "status": "passed",
      "document_type": "mx_ine",
      "expired": true,
      "checksums_valid": true,
      "type_matches": true,
      "country_accepted": true
    },
    "face_match": {
      "status": "passed",
      "similarity": 0
    },
    "data_match": {
      "status": "passed",
      "first_name": "match",
      "last_name": "match",
      "date_of_birth": "match"
    }
  },
  "document_type": "mx_ine",
  "verified_outputs": {
    "first_name": "string",
    "last_name": "string",
    "date_of_birth": "string",
    "document_type": "mx_ine",
    "document_number": "string",
    "issuing_country": "string",
    "expires_on": "string"
  },
  "expires_at": "string",
  "created_at": "string",
  "started_at": "string",
  "submitted_at": "string",
  "decided_at": "string",
  "reviewed_at": "string",
  "redacted_at": "string"
}

{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "object": "verify.session",  "livemode": true,  "tier": "age",  "status": "pending",  "url": "string",  "reference": "string",  "metadata": {    "property1": "string",    "property2": "string"  },  "project_id": "405d8375-3514-403b-8c43-83ae74cfe0e9",  "return_url": "string",  "minimum_age": 0,  "allow_selfie_upload": true,  "show_result": true,  "thresholds": {    "preset": "relaxed",    "liveness_pass": 0,    "liveness_review": 0,    "face_match_pass": 0,    "face_match_review": 0,    "age_buffer_years": 0  },  "options": {    "documents": {      "allowed_types": [        "mx_ine"      ],      "allowed_countries": [        "string"      ],      "max_attempts": 0    },    "rules": {      "liveness_inconclusive": "reject",      "age_inconclusive": "reject",      "document_unreadable": "reject",      "document_expired": "reject",      "document_checksum_failed": "reject",      "document_type_mismatch": "reject",      "document_country_not_accepted": "reject",      "date_of_birth_missing": "reject",      "face_match_inconclusive": "reject",      "age_estimate_mismatch": "reject",      "name_mismatch": "reject",      "date_of_birth_mismatch": "reject"    },    "retention_days": 0  },  "reasons": [    "liveness_failed"  ],  "checks": {    "liveness": {      "status": "passed",      "confidence": 0,      "feedback": [        "face_not_visible"      ]    },    "age": {      "status": "passed",      "minimum_age": 0,      "estimated_low": 0,      "estimated_high": 0,      "estimated_age": 0,      "age_from_document": 0    },    "document": {      "status": "passed",      "document_type": "mx_ine",      "expired": true,      "checksums_valid": true,      "type_matches": true,      "country_accepted": true    },    "face_match": {      "status": "passed",      "similarity": 0    },    "data_match": {      "status": "passed",      "first_name": "match",      "last_name": "match",      "date_of_birth": "match"    }  },  "document_type": "mx_ine",  "verified_outputs": {    "first_name": "string",    "last_name": "string",    "date_of_birth": "string",    "document_type": "mx_ine",    "document_number": "string",    "issuing_country": "string",    "expires_on": "string"  },  "expires_at": "string",  "created_at": "string",  "started_at": "string",  "submitted_at": "string",  "decided_at": "string",  "reviewed_at": "string",  "redacted_at": "string"}

Redactar una sesión

AutorizaciónCopiar enlace

Parámetros de rutaCopiar enlace

Cuerpo de la respuestaCopiar enlace

Autorización

Parámetros de ruta

Cuerpo de la respuesta