Referencia · Cuenta
Organizaciones
GET
/v1/organizations
Devuelve las organizaciones a las que tiene acceso el usuario y, para cada una, lo que puede consultar a través de la API. Esta respuesta no está paginada.
Parámetros
Este endpoint no admite parámetros.
Campos de cada elemento
uidstring- Identificador de la organización. Utilícelo en el parámetro
organizationde los listados. namestring- Nombre de la organización.
neutral_zonebooleantruesi es una organización de zona neutral, cuyos archivos y listas de reproducción pueden usar todas las demás organizaciones.adminbooleantruesi el usuario es administrador de la organización o de la organización principal. En ese caso, lo ve todo en la organización.permissionsobject- Lo que el usuario puede consultar en esta organización.
permissions.tvsbooleantruesi puede ver las TVs.permissions.filesbooleantruesi puede ver los archivos.permissions.playlistsbooleantruesi puede ver las listas de reproducción.
Posibles errores
- Los errores de clave y de límite se aplican a todos los endpoints. Ver todos los errores
Petición
curl "https://api.on-cloud.live/v1/organizations" \
-H "X-API-Key: $API_KEY"<?php
$ch = curl_init('https://api.on-cloud.live/v1/organizations');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['X-API-Key: ' . getenv('API_KEY')],
]);
$response = json_decode(curl_exec($ch), true);const res = await fetch('https://api.on-cloud.live/v1/organizations', {
headers: { 'X-API-Key': process.env.API_KEY }
});
const { data } = await res.json();Respuesta200
{
"data": [
{
"uid": "8f14e45fceea167a5a36dedd4bea2543",
"name": "Loja Centro",
"neutral_zone": false,
"admin": true,
"permissions": {
"tvs": true,
"files": true,
"playlists": true
}
},
{
"uid": "1679091c5a880faf6fb5e6087eb1b2dc",
"name": "Loja Shopping Norte",
"neutral_zone": false,
"admin": true,
"permissions": {
"tvs": true,
"files": true,
"playlists": true
}
}
]
}