Liệt kê playlist

Dành cho đối tác video. Trả về một trang các playlist trong kho video của Wandura, mỗi playlist kèm content_version. Dùng trong job đồng bộ CMS: khi content_version bằng giá trị bạn đã lưu thì không có gì đổi, bạn bỏ qua được Lấy metadata một playlist.

GET /api/delivery/v1/playlists

Scope: metadata:read

Mô tả#

Liệt kê mọi playlist trong kho, thay đổi cũ nhất trước: mọi Category, hoặc một Category với category. Bạn thấy cả kho, không chỉ phần được cấp: granted cho biết playlist nào tổ chức của bạn đã có. Gửi updated_since (giây Unix epoch) để chỉ nhận các playlist đổi sau mốc đó. Playlist Wandura rút khỏi kho — chính playlist đó, hoặc cả Category của nó — vẫn còn trong danh sách dạng withdrawn 30 ngày, để job đồng bộ của bạn kịp thấy; ở dòng withdrawn thì clip_count và content_version là null.

Endpoint này chỉ đọc và không trả link phát: app của bạn phát bản chép trong media space của chính bạn. Key của tổ chức lấy phim nhận 403 4032; hãy dùng Liệt kê bộ phim.

Response thành công được bọc trong envelope {code, message, data, server_time}; lỗi dùng cùng envelope nhưng không có data, trừ 429 và 400 unsupported_version dùng định dạng phẳng. Endpoint này dùng chung bộ đếm rate limit với catalog.

Tham số request#

Giữ nguyên updated_since và category trên mọi trang của một lượt đồng bộ, và đi theo next_cursor tới khi nó là null. Trang đầy luôn kèm next_cursor, nên trang cuối có thể rỗng.

Ví dụ request#

curl -s "https://www.wandura.ai/api/delivery/v1/playlists?category=fitness&updated_since=1790390000&limit=50" \
  -H "Authorization: Bearer $WANDURA_API_KEY"

Response#

200 OK. Trường mới có thể được thêm bất cứ lúc nào: bỏ qua trường bạn không biết.

Các trường của một playlist (data.items[])#

Ví dụ response#

{
  "code": 0,
  "message": "ok",
  "data": {
    "items": [
      {
        "code": "wall-pilates-01",
        "status": "active",
        "title": "Wall Pilates",
        "category": { "slug": "fitness", "name": "Fitness" },
        "group": { "code": "pilates", "title": "Pilates" },
        "clip_count": 24,
        "granted": true,
        "updated_at": 1790390000,
        "content_version": "5d41402abc4b2a76b9719d911017c592",
        "withdrawn_at": null
      },
      {
        "code": "gym-basics-02",
        "status": "active",
        "title": "Gym Basics",
        "category": { "slug": "fitness", "name": "Fitness" },
        "group": { "code": "gym", "title": "Gym" },
        "clip_count": 18,
        "granted": false,
        "updated_at": 1790391000,
        "content_version": "7d793037a0760186574b0282f2f435e7",
        "withdrawn_at": null
      }
    ],
    "next_cursor": null
  },
  "server_time": 1790400000
}

Header của response#

Lỗi#

Xem Lỗi để biết cách xử lý từng trường hợp.