Tài liệu

REST API cho nền tảng QR động Abundera QR Pro. Tạo mã, đổi hướng đích, lấy dữ liệu phân tích lượt quét, quản lý nhóm và triển khai webhook.

Đặc tả API

API Abundera QR Pro tuân theo OpenAPI 3.1. Xem tài liệu tham chiếu tương tác, tải xuống đặc tả, hoặc nhập vào client API bạn ưa thích.

Tài liệu tham chiếu API tương tác →
Mọi endpoint kèm schema yêu cầu và phản hồi, tham số, và thử ngay trong trình duyệt. Vận hành bởi Scalar.
OpenAPI 3.1 (JSON)
Đặc tả đầy đủ, 91 endpoint dành cho khách hàng. Phù hợp nhất để xử lý bằng chương trình.
Bộ sưu tập Postman
Nhập trực tiếp vào Postman hoặc Insomnia để kiểm thử tương tác.
SDKs chính thức
Client có kiểu dữ liệu cho TypeScript, Python và Go. Cấp phép MIT, mã nguồn trên GitHub.
Nhật ký thay đổi
Mọi thay đổi API, có ngày và phiên bản. SemVer; thay đổi phá vỡ tương thích phát hành dưới tiền tố phiên bản chính mới.
API nội bộ
Bề mặt quản trị và thanh toán giữa các dịch vụ. Được ghi lại cho đầy đủ; không dành cho tích hợp của khách hàng.

Xác thực

API QR Pro dùng xác thực bearer-token:

Authorization: Bearer abnd_qrpro_…

URL gốc và định dạng

URL gốc: https://pro.qr.abundera.ai/api

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

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

Giới hạn tốc độ: áp dụng theo từng khóa API, thể hiện qua header phản hồi X-RateLimit-Limit / -Remaining / -Reset. 1k/10k/50k yêu cầu mỗi ngày UTC trên Business / Team / Agency. Đường dẫn chuyển hướng chính (aqr.net/{shortcode}) không cần xác thực và không có ngân sách theo lượt quét.

Ví dụ nhanh

curl -X POST https://pro.qr.abundera.ai/api/v1/codes \
  -H "Authorization: Bearer abnd_qrpro_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"Spring menu","destination":"https://example.com/menu","payload_type":"url"}'

Khám phá (well-known)

Các endpoint tự khám phá dưới /.well-known/ (RFC 8615):

Mục lục /.well-known/ →
Danh sách dễ đọc mọi well-known URI mà trang này công bố.
Năng lực
Phạm vi, hạng giới hạn tốc độ, bề mặt API. Được tổng hợp bởi các giao diện liên kết của hub.
Danh mục API gia đình →
Linkset RFC 9727 trên hub liệt kê mọi API của Abundera.

Liên quan

Bảng giá
Chi tiết các gói Solo, Business, Team, Agency. Quyền truy cập API có từ gói Business trở lên.
Quản lý khóa API
Tạo, xoay vòng và thu hồi khóa tại cổng tài khoản của hub.
Bảo mật & quyền riêng tư
Cách ly theo tenant, lưu trữ dữ liệu quét, webhook đã ký, và mô hình phân tích ưu tiên quyền riêng tư.
Hỗ trợ
Email, trang trạng thái, và lộ trình phát triển công khai.