Chuyển tới nội dung chính

Tổng quan API

AniMapper cung cấp RESTful API để truy cập metadata anime và manga, chức năng tìm kiếm, và thông tin streaming từ các trang web anime Việt Nam.

Base URL​

https://api.animapper.net/api/v1

Xác thực​

Tất cả các endpoint công khai đều mở và không yêu cầu xác thực. Tuy nhiên, giới hạn tốc độ được áp dụng để ngăn chặn lạm dụng.

Giới hạn tốc độ (Rate Limiting)​

API có giới hạn tốc độ để ngăn chặn lạm dụng. Endpoint tìm kiếm có giới hạn cao hơn so với các endpoint khác.

Để biết thêm chi tiết về giới hạn tốc độ, các header response, và cách xử lý, xem Giới hạn tốc độ.

CORS​

Tất cả các endpoint hỗ trợ Cross-Origin Resource Sharing (CORS), cho phép bạn thực hiện requests từ trình duyệt web.

Định dạng Response​

Tất cả các response của API tuân theo một định dạng nhất quán:

Response thành công​

{
  "success": true,
  "results": [...],
  // ... các trường khác
}

Response lỗi​

{
  "success": false,
  "message": "Mô tả lỗi",
  "code": "ERROR_CODE"
}

Mã trạng thái HTTP​

Mã trạng tháiMô tả
200Thành công
400Bad Request - Tham số không hợp lệ
404Not Found - Không tìm thấy tài nguyên
429Too Many Requests - Vượt quá giới hạn tốc độ
500Internal Server Error - Lỗi máy chủ

Mã lỗi thường gặp​

MãMô tả
MISSING_PARAMETERThiếu tham số bắt buộc
INVALID_PARAMETERGiá trị tham số không hợp lệ
INVALID_IDĐịnh dạng ID không hợp lệ
INVALID_PROVIDERTên provider không hợp lệ
UNSUPPORTED_PROVIDERProvider không được hỗ trợ cho thao tác này
MEDIA_NOT_FOUNDKhông tìm thấy media
MAPPING_NOT_FOUNDKhông tìm thấy mapping
EPISODES_NOT_FOUNDKhông tìm thấy tập phim

Các Endpoint API​

Tìm kiếm & Khám phá​

  • Search - Tìm kiếm media với bộ lọc nâng cao
  • Autocomplete - Lấy gợi ý autocomplete

Metadata Media​

  • Metadata - Lấy thông tin chi tiết về media

Streaming​

  • Streaming - Lấy danh sách tập và nguồn stream

Định dạng dữ liệu​

  • Ngày tháng: Định dạng ISO 8601 (YYYY-MM-DD)
  • Timestamp: Unix timestamp tính bằng milliseconds
  • ID: Giá trị số nguyên
  • Enum: Giá trị chuỗi chữ hoa (ví dụ: ANIME, FINISHED, TV)

Phân trang​

Các endpoint trả về danh sách hỗ trợ phân trang:

  • limit: Số lượng kết quả mỗi trang (mặc định: 20, tối đa: 100)
  • offset: Số lượng kết quả cần bỏ qua (mặc định: 0)

Response bao gồm:

  • total: Tổng số kết quả
  • hasNextPage: Boolean cho biết còn kết quả khác không

Ví dụ​

Tất cả các endpoint đều bao gồm ví dụ request và response trong các trang tài liệu tương ứng.