Obtener nodos del negocio

Este endpoint permite consultar los nodos que forman parte de la estructura organizativa de un negocio.

GET /api/v3/businesses/{businessId}/nodes

Si los datos incluidos en la petición son correctos, la respuesta contendrá el listado de nodos del negocio.

Ejemplo de respuesta

[
    {
        "name": "ROOT NODE",
        "orquestId": 35388
    },
    {
        "name": "STORE-1",
        "ancestors": [
            35388,
            35390,
            35413
        ],
        "id": "0001",
        "orquestId": 35391
    },
    {
        "name": "STORE-2",
        "ancestors": [
            35388,
            35823
        ],
        "orquestId": 35824
    }
]
Detalles
  • name: nombre del nodo o servicio.

  • ancestors: lista de identificadores internos de los nodos antecesores en la jerarquía organizativa.

  • id: identificador externo del nodo o servicio.

  • orquestId: identificador interno del nodo o servicio en Orquest.

Como se puede apreciar en el ejemplo, la petición devolverá la información tal y como se haya definido en la estructura organizativa del negocio.

Aspectos que tener en cuenta

El nodo raíz no tiene nodos antecesores.

Si un nodo o servicio no tiene identificador externo configurado en Orquest, la respuesta no incluirá este dato.

Si el negocio no tiene nodos, o el usuario no tiene ninguno visible, la petición devolverá un array vacío [].

Códigos de error

Este endpoint no devuelve códigos de error propios que no se encuentren descritos en errores comunes.

Enlaces de interés

¿Qué es un nodo?

¿Qué es un servicio?

¿Cómo puede ser la estructura organizativa de un negocio?