API Mosaqo
API công khai và webhooks để tự động hóa QR
API công khai Mosaqo sử dụng các khóa trong phạm vi không gian làm việc. Bắt đầu với phạm vi tối thiểu, sử dụng Idempotency-Key để ghi và tôn trọng Thử lại sau khi tốc độ bị giới hạn.
TỔNG QUAN NHANH
Điều này thay đổi gì trong thực tế
01
Xác thực và phạm vi
Gửi bí mật trong X-Mosaqo-API-Key. Phạm vi có sẵn bao gồm qr:read, qr:write, xuất:đọc và phân tích:đọc. Khóa có thể hết hạn, bị thu hồi hoặc sử dụng danh sách IP cho phép.
- Không bao giờ đặt bí mật trong JavaScript máy khách
- Sử dụng một khóa cho mỗi lần tích hợp
- Xoay vòng sau khi nghi ngờ phơi nhiễm
02
Thử ghi lại một cách an toàn
Tạo và xuất bản các yêu cầu yêu cầu Khóa Idempotency từ 1 đến 128 ký tự. Chỉ sử dụng lại khóa để thử lại tải trọng tương tự trong vòng 24 giờ.
03
Giới hạn tỷ lệ và lỗi
Trên HTTP 429, hãy đọc Thử lại sau và thử lại với thời gian chờ. 401 thường biểu thị khóa bị thiếu, bị thu hồi, hết hạn, bị hạn chế hoặc không đủ phạm vi.
04
Webhook
Chỉ đăng ký các sự kiện cần thiết, chấp nhận chúng trên HTTPS và phản hồi nhanh chóng. Mosaqo ghi lại trạng thái phân phối và hỗ trợ phát lại từ không gian làm việc.
FAQ
Câu hỏi thường gặp
Hợp đồng API hoàn chỉnh ở đâu?
Hợp đồng OpenAPI 3.1 được phiên bản với API Mosaqo. Tạo khóa trong không gian làm việc trên web và sử dụng hợp đồng đã xuất bản để biết chi tiết về điểm cuối.
BƯỚC TIẾP THEO