Abundera QR Check/ Tài liệu dành cho nhà phát triển

Tài liệu nhà phát triển

REST API cho dịch vụ phân loại an toàn QR / mã vạch Abundera QR Check. Gửi payload đã giải mã, nhận lại kết quả đã đi qua chuỗi chuyển hướng.

Đặc tả API

API Abundera QR Check tuân theo OpenAPI 3.1. Duyệt tài liệu tham khảo tương tác, tải xuống đặc tả, hoặc nhập vào ứng dụng API client mà bạn ưa thích.

Tài liệu tham khảo API tương tác →
Mọi endpoint với schema yêu cầu/phản hồi, tham số, và thử ngay trong trình duyệt. Được cung cấp bởi Scalar.
OpenAPI 3.1 (YAML)
Đặc tả đầy đủ với schema, mô tả và ví dụ. Tốt nhất cho các công cụ tạo tài liệu.
OpenAPI 3.1 (JSON)
Cùng đặc tả nhưng ở định dạng JSON. Tốt nhất cho xử lý lập trình và công cụ.
Postman Collection v2.1
Nhập vào Postman hoặc Insomnia. Được cấu hình sẵn với biến {{base_url}}{{token}}.

Xác thực

Endpoint công khai POST /api/scan áp dụng giới hạn tốc độ cho cấp ẩn danh (10 yêu cầu mỗi phút, 3 mỗi 24 giờ, theo IP). Cấp Pro trả phí, ra mắt cùng chương trình Thành Viên Sáng Lập, sẽ bỏ giới hạn ẩn danh khi trình API key dưới dạng bearer token:

Authorization: Bearer sk_live_abnd_check_…

API key được tạo khi đăng ký và quản lý tại abundera.ai/account/api-keys. Xác thực được liên kết đến hub và lưu vào KV trong 60 giây.

Base URL & định dạng

URL cơ sở: https://check.qr.abundera.ai

Định dạng yêu cầu: JSON (Content-Type: application/json).

Định dạng phản hồi: JSON (application/json; charset=utf-8). Phản hồi mang trường schema_version.

Ví dụ nhanh

curl -X POST https://check.qr.abundera.ai/api/scan \
  -H "Content-Type: application/json" \
  -d '{"payload":"https://example.com/login"}'

Khám phá (well-known)

Các endpoint tự khám phá theo /.well-known/ (RFC 8615). Duyệt danh mục dạng người đọc, hoặc truy cập trực tiếp:

/.well-known/ mục lục →
Danh sách dạng người đọc mọi URI well-known mà trang này công bố.
Năng lực
Phạm vi, cấp giới hạn tốc độ, giao diện API. Được tổng hợp bởi các UI liên kết của hub.
Chính sách an toàn QR
Schema kết quả của Check, định dạng được hỗ trợ, nguồn dữ liệu danh tiếng, tư thế bảo mật.
Danh mục API gia đình →
RFC 9727 Linkset trên hub liệt kê mọi API của Abundera.

Liên quan

Phạm vi & định dạng được hỗ trợ
Mọi định dạng QR / mã vạch và loại payload mà máy quét nhận diện.
Bảng giá
Cấp Miễn phí và Pro, ưu đãi thành viên sáng lập, và chi tiết giới hạn tốc độ.
Kiến trúc bảo mật
Cách xử lý payload, những gì được lưu cache, và tư thế bảo mật QR-17/18.