[POST] Criar computadores de filas de impressão
Este endpoint cria computadores de filas de impressão.
Chamada
POST /v1/computers
Cabeçalho (header)
Parâmetro | Descrição | Tipo | Obrigatório |
|---|---|---|---|
| Nome do provedor. Para obter essa informação, acesse a documentação: Menus do portal. |
| Sim |
|
| Sim |
Corpo (body)
Parâmetro | Descrição | Tipo | Obrigatório |
|---|---|---|---|
| Nome do cliente, conforme cadastrado no portal NDD Orbix. |
| Sim |
| Lista de computadores. |
| Sim |
| Nome do computador. Não utilize acentos, símbolos (exceto hífen) e espaços. |
| Sim |
Exemplo de requisição
Criar três computadores:
curl -L -X POST 'https://developer.nddorbix.com/printqueue-external-integration-api/v1/computers' \
-H 'Tenant: {tenant}' \
-H 'Authorization: Bearer {token}' \
-H 'Content-Type: application/json' \
-d '{
"Client": "ABC",
"Computers":
[
{
"Hostname": "PC-001"
},
{
"Hostname": "LAPTOP002"
},
{
"Hostname": "SERVER003"
}
]
}'
Em uma mesma requisição, é possível criar até 4.500 computadores.
Para a criação de mais de 4.500 computadores, realize mais de uma requisição.
Exemplo de resposta
A resposta de código 201 indica que:
todos os computadores foram criados com sucesso e retornará o seguinte JSON:
[]ou
houve falha parcial na criação de alguns computadores, e retornará, em JSON, o motivo da falha:
[
{
"hostName": "PC@001",
"errorMessage": "The hostname cannot contain special characters."
},
{
"hostName": "SERVER#003",
"errorMessage": "The hostname cannot contain special characters."
}
]A resposta de código 400 indica que houve falha na criação de todos os computadores e retornará o seguinte JSON:
{
"errors": {
"3400": [
"All computers are invalid."
]
},
"title": "BadRequest",
"status": 400,
"detail": "BusinessException",
"instance": "/v1/computers"
}