Mỗi tuyên bố được thiết kế cho người tiêu dùng; tuyên bố của người tiêu dùng là người đọc và xác minh tuyên bố do người uỷ quyền đưa ra, sau đó hành động dựa trên tuyên bố đó. Cụ thể hơn, người tiêu dùng thực hiện những bước cơ bản sau:
- Yêu cầu danh sách bảng sao kê từ một người dùng cụ thể
- Kiểm tra xem danh sách có chứa một tuyên bố nào đối với một mục tiêu nhất định hay không
- Xác thực rằng mục tiêu trong câu lệnh là mục tiêu (trang web hoặc ứng dụng) mà bạn nghĩ là mục tiêu đó
- Thực hiện hành động được chỉ định bởi câu lệnh nếu bạn chọn
Nhiều trường hợp sử dụng sử dụng câu lệnh cho bạn đằng sau. Ví dụ: tính năng Liên kết ứng dụng Android sử dụng các tuyên bố quyền liên kết do một trang web đưa ra để cho phép truy cập trực tiếp đường liên kết vào một ứng dụng. Một ứng dụng cho biết rằng ứng dụng đồng ý là mục tiêu của những câu lệnh như vậy bằng cách thêm mã đặc biệt (trình xử lý ý định) vào tệp kê khai.
Bạn có thể thực hiện bước 1 và 2 ở trên – yêu cầu và xác thực một câu lệnh – theo hai cách: sử dụng API của chúng tôi hoặc theo cách thủ công (sử dụng cách triển khai của riêng bạn).
Sử dụng câu lệnh bằng Digital Asset Links API (API Đường liên kết đến tài sản kỹ thuật số)
Digital Asset Links API (API Đường liên kết đến tài sản kỹ thuật số) hỗ trợ 2 phương thức: Check()
và List()
để tìm hoặc xác thực tuyên bố:
Check()
lấy nguồn, mục tiêu và mối quan hệ, đồng thời xác minh rằng nguồn đó đưa ra tuyên bố đã gửi về mục tiêu.List()
liệt kê tất cả câu lệnh do một nguồn nhất định đưa ra.
Sử dụng câu lệnh theo cách thủ công
Giao thức Digital Asset Links (Đường liên kết đến tài sản kỹ thuật số) đang mở nên bạn có thể tự triển khai.
Để sử dụng các câu lệnh do trang web đưa ra, bạn có thể tạo yêu cầu HTTP GET cho danh sách câu lệnh tương ứng và tự phân tích cú pháp. Ví dụ: danh sách câu lệnh tương ứng cho trang web http://example.digitalassetlinks.org
là tại http://example.digitalassetlinks.org/.well-known/assetlinks.json
.
Để sử dụng các câu lệnh do ứng dụng Android đưa ra, bạn cần truy cập vào tệp kê khai của gói APK tương ứng. Trên thiết bị Android, bạn có thể thực hiện việc này bằng cách sử dụng giao diện PackageManager.
Vui lòng đặc biệt chú ý đến ý nghĩa cụ thể của các câu lệnh của Digital Asset Links (Đường liên kết đến tài sản kỹ thuật số). Hãy tham khảo Quy cách về đường liên kết đến tài sản nếu bạn không chắc chắn.