Cargar certificado del MH y credenciales de la API del MH por ambiente
PUT
/emitters/{id}/credentials
const url = 'https://api.sudte.com/v1/emitters/example/credentials';const form = new FormData();form.append('environment', '00');form.append('certificate', 'file');form.append('private_key_password', 'example');form.append('mh_user', 'example');form.append('mh_password', 'example');
const options = {method: 'PUT', headers: {Authorization: 'Bearer <token>'}};
options.body = form;
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PUT \ --url https://api.sudte.com/v1/emitters/example/credentials \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: multipart/form-data' \ --form environment=00 \ --form certificate=@file \ --form private_key_password=example \ --form mh_user=example \ --form mh_password=exampleSe guardan cifrados (KMS). Nunca se devuelven. Valida la clave contra el certificado y hace login de prueba en MH.
Autorización
Sección titulada « Autorización »Parámetros
Sección titulada « Parámetros »Parámetros de ruta
Sección titulada « Parámetros de ruta » id
obligatorio
string
Cuerpo de la solicitudobligatorio
Sección titulada « Cuerpo de la solicitudobligatorio » Media type multipart/form-data
object
environment
obligatorio
00 pruebas, 01 producción (CAT-001)
string
certificate
Archivo .crt emitido por el MH
string format: binary
private_key_password
string format: password
mh_user
NIT del usuario de la API del MH
string
mh_password
string format: password
Respuestas
Sección titulada « Respuestas »Credenciales válidas
Media type application/json
object
environment
00 pruebas, 01 producción (CAT-001)
string
certificate_loaded
boolean
certificate_nit
string
mh_login_ok
boolean
checked_at
string format: date-time
mh_user
NIT del usuario de la API del MH (no es secreto)
string
certificate_valid_until
string format: date-time
message
Resultado legible de la última validación o prueba de conexión
string
Example
{ "environment": "00"}Error (RFC 9457)
Media type application/problem+json
object
type
string format: uri
title
string
status
integer
detail
string
instance
string
request_id
string
errors
Array<object>
object
path
string
message
string
mh
object
codigoMsg
string
descripcionMsg
string
observaciones
Array<string>
Example generated
{ "type": "https://example.com", "title": "example", "status": 1, "detail": "example", "instance": "example", "request_id": "example", "errors": [ { "path": "example", "message": "example" } ], "mh": { "codigoMsg": "example", "descripcionMsg": "example", "observaciones": [ "example" ] }}