[GET] Buscar todo el software registrado

Este endpoint obtiene todo el software registrado con el distribuidor, incluyendo detalles sobre el software, su tipo de licencia y los ordenadores vinculados.

Llamada

GET /v1/softwares

Parámetro

Descripción

Tipo

Obligatorio

Tenant

Nombre del distribuidor.

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

string

Sí

Authorization

Token de autenticación obtenido.

string

Sí

Consulta (query)

Parámetro	Descripción	Tipo	Obligatorio
`$count`	Devuelve el número total de elementos que coinciden con la consulta.	`boolean`	No
`$skip`	Omite las primeras n filas de los resultados.	`integer`	No
`$top`	Devuelve sólo las primeras n líneas de los resultados.	`integer`	No
`$select`	Selecciona sólo los campos especificados en los resultados.	`string`	No
`$orderby`	Ordena los resultados basándose en uno o más campos.	`string`	No
`$filter`	Filtra los resultados basándose en una condición.	`string`	No
`$pagesize`	Devuelve el número de registros permitidos por página. Valor aplicado por defecto a todas las llamadas: `500`. Límite máximo: `500`.	`integer`	No

Para más información sobre filtros y paginación, consulte Filtros de búsqueda y Paginación.

Ejemplo de solicitud

Buscar una lista de todo el software del distribuidor:

CODE

curl -L -X GET 'https://developer.nddorbix.com/software-external-integration-api/v1/softwares' \
-H 'Tenant: {tenant}' \
-H 'Authorization: Bearer {token}'

Ejemplo de respuesta

El código de respuesta 200 indica que la búsqueda se ha realizado correctamente y devolverá el JSON con los datos buscados:

CODE

[
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "name": "Software",
    "publisher": "Manufacturer",
    "permission": true,
    "category": "Software Development",
    "organization": {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "displayName": "Organization"
    },
    "softwares": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "version": "1.0.0",
        "installDate": "2025-02-18T11:14:26.230Z",
        "isLicensed": true,
        "licenseExpirationDate": "2025-02-18T11:14:26.230Z",
        "licenseKey": "123456789",
        "computer": {
          "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "name": "Computer"
        }
      }
    ],
    "license": {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "type": 0,
      "isUniqueLicense": true,
      "amount": 0
    }
  }
]

Llamada

Cabecera (header)

Consulta (query)

Ejemplo de solicitud

Ejemplo de respuesta