API para gestionar los certificados CSD de tu cuenta, será posible cargar, consultar y eliminar los certificados.
Para administrar los certificados de manera gráfica, puede hacerlo desde el Administrador de timbres.
🛠 Url Pruebas: https://services.test.sw.com.mx
🧰 Url Productivo: https://services.sw.com.mx
Consultar Certificados
Servicio para consultar todos los certificados cargados en la cuenta.
Endpoint
| Método | Ruta |
| GET | /certificates |
Autenticación y Headers
| Authentication | Bearer Token |
Ejemplo Request
|
1 2 3 4 5 |
curl --request GET \ --url https://services.test.sw.com.mx/certificates \ --header 'Authorization: Bearer $token' |
Consultar Certificado Por NoCertificado
Servicio para obtener un certificado cargado enviando como parámetro el número de certificado.
Endpoint
| Método | Ruta |
| GET | /certificates/{noCertificado} |
Autenticación y Headers
| Authentication | Bearer Token |
Parámetros Path
| Propiedad | Descripción |
| noCertficado | Número de certificado a obtener |
Ejemplo Request
|
1 2 3 4 5 |
curl --request GET \ --url https://services.test.sw.com.mx/certificates/30001000000400002321 \ --header 'Authorization: Bearer $token' |
Cargar Certificado
Servicio para cargar un certificado, el cuál recibe el CSD en Base64.
Endpoint
| Método | Ruta |
| POST | /certificates/save |
Autenticación y Headers
| Authentication | Bearer Token |
| Content-Type | application/json |
Parámetros JSON Body
| Propiedad | Tipo | Uso | Descripción |
| b64Cer | string | Requerido | CSD en Base64 |
| b64Key | string | Requerido | Key en Base64 |
| password | string | Requerido | Contraseña del certificado |
| type | string | Requerido | (Default = “stamp”) Tipo de certificado |
| is_active | string | Requerido | (Default = “true”) Estado del certificado |
Ejemplo Request
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
curl --request POST \ --url https://services.test.sw.com.mx/certificates/save \ --header 'Authorization: Bearer $token' \ --header 'Content-Type: application/json' \ --data '{ "is_active":"true", "type":"stamp", "b64Key":"$b64Key", "b64Cer":"$b64Cer", "password":"12345678a" }' |
Eliminar Certificado
Servicio para eliminar un certificado de la cuenta enviando como parámetro el número de certificado.
Endpoint
| Método | Ruta |
| DELETE | /certificates/{noCertificado} |
Autenticación y Headers
| Authentication | Bearer Token |
Parametros Path
| Propiedad | Descripción |
| noCertficado | Número de certificado a eliminar |
Ejemplo Request
|
1 2 3 4 5 |
curl --request DELETE \ --url https://services.test.sw.com.mx/certificates/30001000000400002335 \ --header 'Authorization: Bearer $token' |