Rights Data API

Giới thiệu

Rights Data API cho phép đối tác truy vấn hồ sơ quyền theo mã DIP-ID hoặc định danh quốc tế (ISWC/ISRC), xác thực chứng nhận tác phẩm và kiểm tra trạng thái giấy phép (Blanket/Individual). Đây là lớp ĐỌC — không thực hiện đăng ký hay thanh toán.

Lấy khoá thử nghiệm ngay

Điền email là có khoá dùng ngay, không cần đăng nhập và không phải chờ ai duyệt. Khoá thử nghiệm chỉ đọc được dữ liệu giả lập, hình dạng dữ liệu giống hệt môi trường thật nên mã tích hợp viết ở đây chạy được ngay khi chuyển sang khoá thật (Nghị định 277/2026 Điều 7 khoản 5).

Xem danh sách mã dùng thử tại GET /api/v1/public/v1/sandbox/fixtures — mọi bản ghi đều mang tiền tố SANDBOX- để không nhầm với dữ liệu thật.

Chạy thử ngay trên trang

Chọn một ví dụ rồi bấm Chạy thử. Lượt gọi đi thẳng tới API bằng chính khoá thử nghiệm của bạn — không phải bản mô phỏng. Dữ liệu trả về là dữ liệu GIẢ LẬP theo Nghị định 277/2026 Điều 7 khoản 5.

Đặc tả OpenAPI

Đặc tả OpenAPI 3.1 mô tả toàn bộ endpoint công khai kèm ví dụ chạy được. Nạp thẳng vào Postman, Insomnia hoặc bộ sinh mã nguồn.

curl https://<domain>/api/v1/public/v1/openapi.json

Xác thực

Mọi request cần API key gửi qua header. Liên hệ quản trị DIP để được cấp khoá và scope phù hợp.

curl -H "x-api-key: rdas_live_xxxxxxxx" \
     https://<domain>/api/v1/public/v1/rights/DIP-WK-MUS-2026-000123

Base URL

https://<domain>/api/v1/public/v1

Thay <domain> bằng tên miền DIP thực tế.

Hạn mức

Mỗi client có hạn mức riêng (mặc định 60 request/phút). Phản hồi kèm header X-RateLimit-Limit / X-RateLimit-Remaining / X-RateLimit-Reset. Vượt hạn mức trả HTTP 429.

Phạm vi quyền (scope)

Endpoint

Tài liệu OpenAPI tương tác (môi trường không phải production) tại /api/docs.

Dành cho tổ chức thẩm định giá, ngân hàng và công chứng

Khi phải lập hồ sơ dựa trên tài sản vô hình của người khác, câu hỏi đầu tiên luôn là: tài sản này có thật không, tồn tại từ bao giờ, và quyền thuộc về ai. Một điểm gọi duy nhất trả về đủ dữ kiện đó — mã định danh, thời điểm hệ thống ghi nhận sớm nhất, mã băm tệp để đối chiếu tính toàn vẹn, chuỗi quyền tác giả và quyền liên quan, thời hạn bảo hộ còn lại, tình trạng tranh chấp trên nền tảng, và đường tra cứu công khai để bên thứ ba tự kiểm.

Thử ngay, không cần đăng ký

Khoá môi trường thử nghiệm cấp tự động qua một lời gọi. Dữ liệu là giả lập, nhưng hình dạng phản hồi giống hệt bản thật nên mã tích hợp viết ở đây chạy được ngay khi chuyển sang khoá thật.

# 1. Lấy khoá thử nghiệm (không cần đăng ký tài khoản)
curl -X POST https://<domain>/api/v1/public/v1/sandbox/register \
     -H "Content-Type: application/json" \
     -d '{"email":"ban@vidu.vn"}'

# 2. Gọi gói bằng chứng bằng khoá vừa nhận
curl -H "x-api-key: rdas_sbx_xxxxxxxx" \
     https://<domain>/api/v1/public/v1/rights/SANDBOX-WK-PHO-2026-000003/evidence

Gói quyền truy cập theo nghề

Danh mục dữ liệu mở

Từng tập dữ liệu kèm danh sách trường, điều kiện dùng lại, tần suất cập nhật, và cả những gì KHÔNG có trong đó. Phân loại theo Điều 11 khoản 3 Nghị định 277/2026.

Nhận API key

DIP cấp khoá theo thoả thuận. Liên hệ để đăng ký tài khoản đối tác và nhận khoá + scope.