Skip to main content
Skip table of contents

[POST] Crear ordenadores de cola de impresión

Este endpoint crea los ordenadores de la cola de impresión.

Llamada

POST /v1/computers

Cabecera (header)

Parámetro

Descripción

Tipo

Obligatorio

Tenant

Nombre del distribuidor.

Para obtener esta información, consulte la documentación: Menús del portal.

string

Authorization

Token de autenticación obtenido.

string

Cuerpo (body)

Parámetro

Descripción

Tipo

Obligatorio

Client

Nombre del cliente, tal y como está registrado en el portal NDD Orbix.

string

Computers

Lista de ordenadores.

array

Hostname

Nombre del ordenador.

No utilice acentos, símbolos (excepto guiones) y espacios.

string

Ejemplo de solicitud

Crear tres ordenadores:

CODE
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"
        }
    ]
}'

En una única solicitud puede crear hasta 4.500 ordenadores.

Para crear más de 4.500 ordenadores, realice más de una solicitud.

Ejemplo de respuesta

El código de respuesta 201 indica que:

  • todos los ordenadores han sido creados correctamente y devolverá el siguiente JSON:

CODE
[]

o

  • se ha producido un fallo parcial en la creación de algunos ordenadores y devolverá el motivo del fallo en JSON:

CODE
[
    {
        "hostName": "PC@001",
        "errorMessage": "The hostname cannot contain special characters."
    },
    {
        "hostName": "SERVER#003",
        "errorMessage": "The hostname cannot contain special characters."
    }
]

La respuesta de código 400 indica que hubo un fallo al crear todos los ordenadores y devolverá el siguiente JSON:

CODE
{
    "errors": {
        "3400": [
            "All computers are invalid."
        ]
    },
    "title": "BadRequest",
    "status": 400,
    "detail": "BusinessException",
    "instance": "/v1/computers"
}
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.