ማጣቀሻ · ፕሌይሊስቶች

ፕሌይሊስቶችን መዘርዘር

GET /v1/playlists

ተጠቃሚው ፕሌይሊስቶችን ማየት በሚችልባቸው ድርጅቶች ውስጥ ያሉትን ፕሌይሊስቶች በፊደል ቅደም ተከተል ይዘረዝራል።

በገጾች የተከፋፈለ ምላሽ፦ ንጥሎቹ በdata ውስጥ፣ የገጹ መረጃ ደግሞ በmeta ውስጥ ይመጣሉ። ገጽ መከፋፈል እና ማጣሪያዎች

ፓራሜትሮች

ስም	አይነት	መግለጫ
`organization`	`string`	የአንድ ድርጅት uid፣ የእሱን ንጥሎች ብቻ ለማምጣት (`/organizations`ን ይመልከቱ)።
`q`	`string`	የስሙ ክፍል፣ እስከ 100 ቁምፊዎች።
`page`	`integer`	ገጽ፣ ከ1 ጀምሮ። ነባሪ፦ 1።
`per_page`	`integer`	በአንድ ገጽ ያሉ ንጥሎች፣ ከ1 እስከ 100። ነባሪ፦ 50።

የእያንዳንዱ ንጥል መስኮች

uid string: የፕሌይሊስቱ ለዪ።
name string: የፕሌይሊስቱ ስም።
organization object: የፕሌይሊስቱ ድርጅት፦ uid እና name።
total_time integer: የፕሌይሊስቱ ጠቅላላ ጊዜ፣ በሰከንድ።
total_time_is_approximate boolean: ጠቅላላ ጊዜው ግምት ከሆነ true።

ሊከሰቱ የሚችሉ ስህተቶች

400 invalid_parameter አንድ ፓራሜትር ልክ ያልሆነ ዋጋ አለው፤ ለምሳሌ ከከፍተኛው በላይ የሆነ per_page።
404 organization_not_found የተሰጠው organization ተጠቃሚው ይህን አይነት ንጥል ማየት የሚችልበት ድርጅት አይደለም።
የቁልፍ እና የገደብ ስህተቶች ለሁሉም ኢንድፖይንቶች ይሠራሉ። ሁሉንም ስህተቶች ይመልከቱ

ጥያቄcURLPHPJavaScript

curl "https://api.on-cloud.live/v1/playlists?per_page=2" \
  -H "X-API-Key: $API_KEY"

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

ምላሽ200

{
  "data": [
    {
      "uid": "1f0e3dad99908345f7439f8ffabdffc4",
      "name": "Lista do caixa",
      "organization": {
        "uid": "1679091c5a880faf6fb5e6087eb1b2dc",
        "name": "Loja Shopping Norte"
      },
      "total_time": 40,
      "total_time_is_approximate": false
    },
    {
      "uid": "e4da3b7fbbce2345d7772b0674a318d5",
      "name": "Lista principal",
      "organization": {
        "uid": "8f14e45fceea167a5a36dedd4bea2543",
        "name": "Loja Centro"
      },
      "total_time": 85,
      "total_time_is_approximate": true
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 2,
    "total": 2,
    "total_pages": 1
  }
}