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 (número entero): Identificador (id) del cliente, opcional. 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 (número entero): Identificador (id) del cliente, opcional. Solo para guardar los certificados del cliente.

POST /

{
  "file": {
    "content": "data:...",
    "contentType": "application/pfx",
    "name": "certificate.pfx"
  },
  "password": "123456",
  "clientId": 1
}

Respuesta

{
  "success": true,
  "message": "OK",
  "data": {
    "cert_secret": "code"
  }
}

Eliminar un certificado

Parámetros

cert_secret (caracteres): Clave secreta asociada al certificado.

DELETE /{cert_secret}

cert_secret

Respuesta

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

Eliminar un cliente Obtener los certificados