Niucore

Referencia

Áreas

La unidad sobre la que se reparten bibliotecas, habilidades y conectores.

Listar áreas

GETapi.niucore.com/api/v1/areas

Scope: areas:read

Áreas visibles para la credencial. Son la unidad sobre la que se reparten bibliotecas, habilidades y conectores.

Nota

Las áreas son de solo lectura en la v1.0: crearlas o editarlas es administración de la organización, no automatización.

Consulta

pageintegerpor defecto 1

Página, empezando en 1.

sizeintegerpor defecto 50

Elementos por página. Máximo 200.

curl -sS -X GET 'https://api.niucore.com/api/v1/areas' \
  -H "Authorization: Bearer $NIUCORE_ACCESS_TOKEN"
Respuesta
{
  "status": "success",
  "message": "Operación exitosa",
  "message_code": "api_v1_ok",
  "data": [
    {
      "id": 4,
      "name": "Soporte",
      "description": "Atención al cliente y postventa.",
      "created_at": "2026-02-04T16:20:00Z"
    }
  ],
  "meta": {
    "request_id": "9f1c0a3e-7b2d-4f18-9a55-2c6e0d1b4a77",
    "page": 1,
    "size": 50,
    "total": 1
  }
}

Ver un área

GETapi.niucore.com/api/v1/areas/{area_id}

Scope: areas:read

Detalle de un área.

Ruta

area_idintegerobligatorio

Identificador.

Errores

  • 404api_v1_not_foundNo existe, o está fuera del alcance de la credencial. Los dos casos responden igual: un 403 confirmaría que el recurso existe.
curl -sS -X GET 'https://api.niucore.com/api/v1/areas/4' \
  -H "Authorization: Bearer $NIUCORE_ACCESS_TOKEN"
Respuesta
{
  "status": "success",
  "message": "Operación exitosa",
  "message_code": "api_v1_ok",
  "data": {
    "id": 4,
    "name": "Soporte",
    "description": "Atención al cliente y postventa.",
    "created_at": "2026-02-04T16:20:00Z"
  },
  "meta": {
    "request_id": "9f1c0a3e-7b2d-4f18-9a55-2c6e0d1b4a77"
  }
}