Referans · Dosyalar

Bir dosyayı görüntüle

Bir dosyayı uid değerine göre; boyutu, çözünürlüğü, orijinal dosyanın URL'si ve dosyanın bulunduğu oynatma listeleriyle birlikte döndürür.

Yol parametresi

Yanıt alanları

uid string

Dosya tanımlayıcısı.

name string

Dosyanın kontrol panelindeki adı.

type string

Dosya türü, ör. image veya video.

duration integer

Süre, saniye cinsinden.

archived boolean

Dosya arşivlenmişse true.

organization object

Dosyanın kuruluşu: uid ve name.

size integer

Orijinal dosyanın boyutu, bayt cinsinden.

width integer

Orijinal dosyanın genişliği, piksel cinsinden.

height integer

Orijinal dosyanın yüksekliği, piksel cinsinden.

aspect_ratio string

Genişliğin yüksekliğe oranı, ör. 1.78.

url string

Orijinal dosyanın URL'si veya dosya kullanılamıyorsa boş metin.

scheduled boolean

Dosyanın etkin bir zamanlaması varsa true.

playlists array

Dosyanın bulunduğu oynatma listeleri (uid, name ve organization). Yalnızca kullanıcının görebildiği listeler gösterilir.

Olası hatalar

• 404 not_found Uç nokta mevcut değil ya da öğe mevcut değil veya kullanıcının göremediği bir kuruluşa ait.
• Anahtar ve limit hataları tüm uç noktalar için geçerlidir. Tüm hataları görün

curl "https://api.on-cloud.live/v1/files/a87ff679a2f3e71d9181a67b7542122c" \
  -H "X-API-Key: $API_KEY"

<?php
$ch = curl_init('https://api.on-cloud.live/v1/files/a87ff679a2f3e71d9181a67b7542122c');
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/files/a87ff679a2f3e71d9181a67b7542122c', {
  headers: { 'X-API-Key': process.env.API_KEY }
});
const { data } = await res.json();

{
  "data": {
    "uid": "a87ff679a2f3e71d9181a67b7542122c",
    "name": "Promoção de verão",
    "type": "video",
    "duration": 30,
    "archived": false,
    "organization": {
      "uid": "8f14e45fceea167a5a36dedd4bea2543",
      "name": "Loja Centro"
    },
    "size": 18734520,
    "width": 1920,
    "height": 1080,
    "aspect_ratio": "1.78",
    "url": "https://oncloud.bunny.files.on-cloud.live/files/a87ff679a2f3e71d9181a67b7542122c-1.mp4",
    "scheduled": true,
    "playlists": [
      {
        "uid": "e4da3b7fbbce2345d7772b0674a318d5",
        "name": "Lista principal",
        "organization": {
          "uid": "8f14e45fceea167a5a36dedd4bea2543",
          "name": "Loja Centro"
        }
      }
    ]
  }
}

{
  "error": {
    "code": "not_found",
    "message": "Item not found or you do not have access to it."
  }
}