Tài liệu tham chiếu API

Phần tham chiếu mô tả từng endpoint của Wandura Delivery API: tham số, trường, ví dụ, header và lỗi, sinh ra từ bản mô tả OpenAPI. Các quy tắc chung cho mọi endpoint — xác thực, phân trang, thời hạn vé, độ mới, retry, rate limit, phiên bản — nằm ở Hành vi chuẩn của API.

Base URL#

https://www.wandura.ai

Luôn dùng www.wandura.ai. Tên miền trần trả 308 sang www, và một số HTTP client làm rơi body hoặc header của POST khi đi theo redirect.

Endpoint#

Mọi đường dẫn khác dưới /api/delivery/v1/ trả 404 not_found; một đường dẫn có thật nhưng sai method trả 405.

Hợp đồng cho máy đọc: bản mô tả OpenAPI 3 của mọi endpoint ở trên được đăng tại https://docs.wandura.ai/developers/openapi/delivery-v1.json. Dùng nó để sinh client hoặc kiểm tra tích hợp của bạn. Trong /v1 nó chỉ thay đổi theo kiểu thêm vào.

Chỉ server-to-server#

Gọi các endpoint này từ backend, không bao giờ từ trình duyệt hay app: chúng không gửi header CORS, và key nằm trong client thì có thể bị trích ra. Xem Bảo mật.

Request và response#

• Body là JSON. Gửi Content-Type: application/json với POST.
• ID của phim, tập, creative và video là chuỗi UUID.
• Thời gian là chuỗi ISO 8601 theo UTC (expires_at), trừ feed creative, nơi dùng giây Unix epoch.
• Mọi response đều mang Wandura-Version và Wandura-API-Status: beta.
• Bỏ qua các trường, giá trị và mã lỗi bạn không nhận ra: xem Phiên bản và tiến hoá API.

Các quy tắc chung nằm ở đâu#

Beta#

API đang ở bản beta. Trong giai đoạn beta, Wandura vẫn có thể đổi hành vi bên trong /v1, theo quy tắc beta; mọi thay đổi đều có trong nhật ký thay đổi.