API de distribuição

Leitura estimada: 2 minutos

API de distribuição

Ponto de extremidade: https://environment-smartcenter.almaden.app/api/distribution/api/auth

Método: POST

Parâmetros via corpo:

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

Método para retornar um dispositivo

Ponto de extremidade: 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 criar uma distribuição

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

Parâmetros via corpo:

{
"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 o status da distribuição

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

Possíveis respostas:

Descrição	Código	Resposta
Tarefa agendada, aguardando execução.	200	{ “status”: true, “data”: { “delivered”: “scheduled” } }
Tarefa em andamento.	200	{ “status”: true, “data”: { “startTime”: “2021-03-30 16:43:23.000000”, “delivered”: “running” } }
A distribuição foi realizada com sucesso.	200	{ “status”: true, “data”: { “startTime”: “2021-03-30 16:43:23.000000”, “stopTime”: “2021-03-30 16:43:40.000000”, “delivered”: “Y”, “error”: “” } }
Programação de tarefas de distribuição expirada.	400	{ “status” :false, “data” : {}, “error”: “Expired Job” }
Programação de tarefas de distribuição expirada.	400	{ “status” :false, “data” : {}, “error”: “Job not found” }
Token de acesso inválido.	403	{ “status”: false, “data”: {}, “error”: “Unauthorized access” }

API de distribuição