Certificados

Certificados digitales

Parámetros en la cabecera HTTP

Authorization (caracteres): Autorización de la API. Ejemplo: Bearer {token}

URL base


https://api.saltra.es/api/v4/certificate

Obtener los certificados

Parámetros

clientId opcional (número entero): Identificador (id) del cliente. Solo para consultar los certificados del cliente.

GET /


{
  "clientId": 1
}

Respuesta


{
  "success": true,
  "message": "OK",
  "data": {
    "data": [
      {
        "name": "99999999",
        "desde": "2023-12-12",
        "expired": "2026-12-12",
        "dni": "ISSS-999999Q",
        "gn": "NAME",
        "sn": "NAME",
        "type": 1,
        "active": 1,
        "cert_secret": "283261f59c9c4fqh123f8defe269999999e3c17b21"
      }
    ],
    "pagination": {
      "page": 1,
      "lastPage": 1,
      "perPage": 50,
      "total": 2
    }
  }
}

Guardar un certificado

Parámetros

file (archivo): Certificado en formato P12 o PFX.
password (caracteres): Contraseña del certificado.
clientId opcional (número entero): Identificador (id) del cliente. Solo para guardar los certificados del cliente.
type (número entero): Tipo de certificado, posibles valores:
- 1: Autorizado RED (TGSS)
- 2: SEPE
- 3: Hacienda (AEAT)
- 5: DEHU

POST /


curl -X POST https://api.saltra.es/api/v4/certificate \
-H 'Authorization: bearer *token*' \
-H 'Accept: application/json' \
-F 'password="1234"' \
-F 'type="1"' \
-F 'clientId="1"' \
-F 'file=@"certificado.p12"'

Respuesta


{
  "success": true,
  "message": "OK",
  "data": {
      "name": "99999999",
      "desde": "2023-12-12",
      "expired": "2026-12-12",
      "dni": "ISSS-999999Q",
      "gn": "NAME",
      "sn": "NAME",
      "type": 1,
      "active": 1,
      "cert_secret": "283261f59c9c4fqh123f8defe269999999e3c17b21"
  }
}

Eliminar un certificado

Parámetros

cert_secret (caracteres): Clave secreta asociada al certificado.

DELETE /{cert_secret}


cert_secret

Respuesta


{
  "success": true,
  "message": "OK"
}