...

API de distribución

Lectura estimada: 2 minutos

API de distribución

Punto final: https://environment-smartcenter.almaden.app/api/distribution/api/auth

Método: POST

Parámetros a través del cuerpo:

{
“automatosId”: “123456789”, “automatosKey”: “ABCDEFGH=”
}
 
response code(200):
 
{
“status”: true, “data”: {
“token”: “ABCDEF12345”
}
}
 
response code(400):
 
{
“status”: false, “data”: {},
“error”: “invalid credential”
}


Método para devolver un dispositivo

Punto final: https://environment-smartcenter.almaden.app/api/distribution/api/machine?hostname=NTB1

Método: GET
Header Autorization: “Bearer <token>”
Parameter via url: hostname=NTB1
Resposta code(200)

{
"status": true, "data": {
"machines": [
{
"machineId": "123ABC", "hostname": "NTB1", "department": "DEV"
},
{
 
"machineId": "ABC987",
"hostname": "NTB1", "department": "Comercial"
},
]
}
}

response code(400)
{
"status": false, "data": {},
"error": "machine not found"
}


Método para crear una distribución

Endpoint: https:// environment-smartcenter.almaden.app/api/distribution/api/express/distribution
Método: POST
Header Autorization: “Bearer <token>”

Parámetros a través del cuerpo:

{
"machineId" : "123ABC", "package" : "7zip.exe", "domain" : "AUTOMATOS",
"user" : "user",
"password" : "pass", "irradiadora" : "0050568"
}

response code(200)

{
"status" : true, "data" : {
"jobName" : "ASDF123456"
}
}

response code(400)

{
"status": false, "data": {},
"error": "Something went wrong"
}


Método para consultar el estado de la distribución

Endpoint: https://environment-smartcenter.almaden.app/api/distribution/api/express/distribution?jobName=ASDF123456
Method: GET
Header Autorization: “Bearer <token>”
Parameter via url: jobName= ASDF123456

Posibles respuestas:

DescripciónCódigo Respuesta
Tarea programada, a la espera de ejecutarse.200{   “status”: true,   “data”: {     “delivered”: “scheduled”   } }
Tarea en curso.200{   “status”: true,   “data”: {     “startTime”: “2021-03-30 16:43:23.000000”,     “delivered”: “running”   } }
Distribución realizada con éxito.200{   “status”: true,   “data”: {     “startTime”: “2021-03-30 16:43:23.000000”,     “stopTime”: “2021-03-30 16:43:40.000000”,     “delivered”: “Y”,     “error”: “”   } }
Programación de tareas de distribución caducada.400{      “status” :false,      “data” : {},      “error”: “Expired Job” }  
Programación de tareas de distribución caducada.400{      “status” :false,      “data” : {},      “error”: “Job not found” }
Token de acceso inválido.403{   “status”: false,   “data”: {},   “error”: “Unauthorized access” }
Compartir este documento

API de distribución

O copie el enlace

Índice
Ir arriba