Validación de eFirma
El endpoint de validación de eFirma usa los archivos que conforman una e.firma y valida que localmente sean correctos y remotamente saber si está revocada.
Método: POST
Encabezados de la Solicitud
Sección titulada «Encabezados de la Solicitud»Para realizar la solicitud es necesario incluir los siguientes encabezados:
| Encabezado | Valor | Descripción |
|---|---|---|
| Accept | application/json | Tipo de contenido de la solicitud. |
| Authorization | Bearer {tu_token} | Token generado para autenticar al usuario. |
Cuerpo de la Solicitud
Sección titulada «Cuerpo de la Solicitud»El cuerpo de la solicitud debe contener los siguientes parámetros:
| Parámetro | Tipo | Descripción |
|---|---|---|
| key | String | Archivo .key de la efirma codificado en base64 |
| cer | String | Archivo .cer de la efirma codificado en base64 |
| password | Opcional String | Contraseña de la efirma |
Ejemplo del cuerpo de la solicitud
Sección titulada «Ejemplo del cuerpo de la solicitud»{ "key": "data:application/octet-stream;base64,MIIE...", "cer": "data:application/octet-stream;base64,MIID...", "password": "password123"}Respuesta del Endpoint
Sección titulada «Respuesta del Endpoint»{ "data": { "object": "SatValidation", "id": 60, "message": "El certificado no es válido ante el SAT", "status": false, "certificate_data": { "subject": { "CN": "XOCHILT CASAS CHAVEZ", "name": "XOCHILT CASAS CHAVEZ", "O": "XOCHILT CASAS CHAVEZ", "C": "MX", "emailAddress": "pruebas@pruebas.gob.mx", "x500UniqueIdentifier": "CACX7605101P8", "serialNumber": "CACX760510MGTSHC04" }, "issuer": { "CN": "AC UAT", "O": "SERVICIO DE ADMINISTRACION TRIBUTARIA", "OU": "SAT-IES Authority", "emailAddress": "oscar.martinez@sat.gob.mx", "street": "3ra cerrada de caliz", "postalCode": "06370", "C": "MX", "ST": "CIUDAD DE MEXICO", "L": "COYOACAN", "x500UniqueIdentifier": "2.5.4.45", "unstructuredName": "responsable: ACDMA-SAT" }, "validFrom": "2023-05-09 18:05:49", "validTo": "2027-05-08 18:05:49", "serialNumber": "0x3330303031303030303030353030303033323832", "validity": true }, "validations": { "satValidation": false, "isPairValidation": true, "validity": true }, "created_at": "2024-06-06T20:00:19.000000Z", "updated_at": "2024-06-06T20:00:19.000000Z", "real_id": 60, "readable_created_at": "hace 1 segundo", "readable_updated_at": "hace 1 segundo" }, "meta": { "include": [], "custom": [] }}Este error ocurre si falta algún parámetro o si el parámetro no es una cadena de caracteres.
{ "message": "El campo key debe ser una cadena de caracteres. (and 1 more error)", "errors": { "key": [ "El campo key debe ser una cadena de caracteres.", "El campo key es obligatorio." ] }}