# Validación de eFirma

Fuente: /miscellaneous/efirma-validation/

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**

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**

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**

```json
{
    "key": "data:application/octet-stream;base64,MIIE...",
    "cer": "data:application/octet-stream;base64,MIID...",
    "password": "password123"
}
```

### Respuesta del Endpoint

**status 200**

```json
{
    "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": []
    }
}
```

**status 422**

Este error ocurre si falta algún parámetro o si el parámetro no es una cadena de caracteres.

```json
{
    "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."
        ]
    }
}
```