Referência · Conta

Empresas

GET /v1/organizations

Lista as empresas a que o utilizador tem acesso e, em cada uma, o que pode consultar através da API. Esta resposta não é paginada.

Parâmetros

Este endpoint não recebe parâmetros.

Campos de cada item

uid string
Identificador da empresa. Utilize-o no parâmetro organization das listagens.
name string
Nome da empresa.
neutral_zone boolean
true se for uma empresa neutra, cujos ficheiros e listas de reprodução podem ser utilizados por todas as outras empresas.
admin boolean
true se o utilizador for administrador da empresa ou da empresa principal. Nesse caso, vê tudo da empresa.
permissions object
O que o utilizador pode consultar nesta empresa.
permissions.tvs boolean
true se pode ver as TVs.
permissions.files boolean
true se pode ver os ficheiros.
permissions.playlists boolean
true se pode ver as listas de reprodução.

Erros possíveis

Pedido
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();
Resposta200
{
  "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
      }
    }
  ]
}