API & Tích hợp

Cập nhật lần cuối: tháng 5 năm 2026

1. Giới thiệu API MOWISA

API MOWISA cho phép các nhà phát triển tích hợp dữ liệu điện ảnh Việt Nam vào các ứng dụng, website và dịch vụ của họ. Chúng tôi cung cấp REST API có cấu trúc tốt với tài liệu toàn diện.

🚀 Thông báo: API công khai của MOWISA sẽ sớm được ra mắt. Đăng ký tại trang Liên hệ hỗ trợ để nhận thông báo.

2. Các Endpoint Chính

Khi API được ra mắt, nó sẽ bao gồm các endpoint sau:

/api/movies
Lấy danh sách phim với bộ lọc, sắp xếp và phân trang

/api/movies/{id}
Lấy thông tin chi tiết về một bộ phim cụ thể

/api/people
Lấy danh sách diễn viên, đạo diễn, nhà sản xuất

/api/people/{id}
Lấy thông tin chi tiết về một nghệ sĩ cụ thể

/api/genres
Lấy tất cả thể loại phim

/api/search
Tìm kiếm phim, nghệ sĩ và nội dung khác

3. Xác thực

Để sử dụng API MOWISA, bạn cần:

Tạo tài khoản nhà phát triển trên MOWISA
Tạo API key trong bảng điều khiển của bạn
Gửi API key trong header Authorization của mỗi request

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.mowisa.local/v1/movies
    

4. Hạn mức (Rate Limiting)

API MOWISA có các hạn mức sau:

Free Plan: 1,000 request/tháng
Developer Plan: 100,000 request/tháng
Enterprise Plan: Không giới hạn (liên hệ bán hàng)

5. Định dạng Phản hồi

Tất cả phản hồi API được trả về dưới dạng JSON:

{
  "success": true,
  "data": {
    "movies": [
      {
        "id": "m-001",
        "title": "Tên phim",
        "releaseYear": 2024,
        "rating": 8.5,
        "posterUrl": "https://...",
        "overview": "Mô tả"
      }
    ]
  },
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 150
  }
}
    

6. Các Trường hợp Sử dụng Phổ biến

API MOWISA có thể được sử dụng cho:

Xây dựng ứng dụng khiến tìm kiếm phim
Hiển thị suy đề xuất phim trên website của bạn
Tạo ứng dụng di động về điện ảnh Việt Nam
Nhúng dữ liệu MOWISA vào các nền tảng khác
Tạo bảng xếp hạng và phân tích tùy chỉnh
Xây dựng trang web so sánh phim

7. Các Thực hành Tốt Nhất

Sử dụng bộ đệm (cache) để giảm số lượng request
Xử lý lỗi API một cách hợp lý
Không lạm dụng hạn mức request
Cảm ơn MOWISA trong ứng dụng của bạn
Tuân thủ Điều khoản Sử dụng

8. Tài liệu Đầy đủ

Tài liệu API chi tiết, mẫu code và SDK sẽ có sẵn tại https://developers.mowisa.local khi API được ra mắt.

9. Hỗ trợ và Phản hồi

Có bất kỳ câu hỏi nào về API hoặc tích hợp? Hãy liên hệ với chúng tôi qua trang Liên hệ hỗ trợ. Chúng tôi rất muốn nghe từ các nhà phát triển!

Tùy chỉnh Giao diện Đóng