Liệt kê bộ phim

Trả về một trang các bộ phim tổ chức của bạn được cấp quyền, mỗi bộ 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 bộ phim.

GET /api/delivery/v1/series

Scope: metadata:read

Mô tả#

Liệt kê các bộ bạn được cấp quyền, thay đổi cũ nhất trước. Gửi updated_since (giây Unix epoch) để chỉ nhận các bộ đổi sau mốc đó. Bộ hết giấy phép 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. 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.

CMS của bạn được sửa đè bất kỳ trường nào. Wandura không bao giờ ghi đè bản sửa của bạn: lưu content_version đã nhập và giữ bản sửa của bạn.

Tham số request#

Giữ nguyên updated_since trên mọi trang của một lượt đồng bộ, và đi theo next_cursor tới khi nó là null.

Ví dụ request#

curl -s "https://www.wandura.ai/api/delivery/v1/series?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 bộ (data.items[])#

Ví dụ response#

{
  "code": 0,
  "message": "ok",
  "data": {
    "items": [
      {
        "code": "WD000016",
        "status": "active",
        "updated_at": 1790390000,
        "content_version": "c3f1a9e07b2d4c5e8f9a0b1c2d3e4f50",
        "episode_count": 60,
        "withdrawn_at": null
      },
      { "code": "WD000021", "status": "withdrawn", "updated_at": 1790395000, "content_version": null, "episode_count": null, "withdrawn_at": 1790395000 }
    ],
    "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.