Hướng dẫn thực tế Qivo
Làm thế nào một QR Code Generation API hoạt động
Một API cho phép bạn tạo mã QR tự động từ trang web, công cụ nội bộ hoặc kịch bản của bạn.
Ứng dụng của bạn gửi nội dung và cài đặt; Qivo trả về một hình ảnh QR tĩnh.
Từ Manual Editor đến Integration
Trong biên tập, một người điền vào các trường và nhấp vào tải xuống. Với một API, một chương trình thực hiện những hành động này, ví dụ như tạo ra một trang sản phẩm mã QR trong khi chuẩn bị một nhãn.
Một cuộc gọi API không làm cho mã năng động. hình ảnh lưu trữ dữ liệu được gửi thay vì một URL Qivo trung gian. bạn có thể lưu và sử dụng tệp mà không liên hệ với máy phát lại.
Những gì một yêu cầu chứa
Một yêu cầu GET chứa địa chỉ dịch vụ, thông số và một khóa bí mật. nội dungType thông số chọn loại dữ liệu, định dạng chọn PNG hoặc SVG, và hình dạng, biên giới và trung tâm kiểm soát thiết kế.
Các giá trị thông số phải được mã hóa bằng URL. Sử dụng các công cụ tiêu chuẩn của ngôn ngữ của bạn để quản lý đúng các không gian, + trong số điện thoại và # trong màu sắc. Không hợp lệ hoặc thiếu các trường cần thiết gây ra phản ứng lỗi.
Tại sao chìa khóa thuộc về máy chủ của bạn
Chìa khóa cung cấp quyền truy cập vào thế hệ.Người truy cập có thể đọc một chìa khóa được đặt trong JavaScript của một trang công cộng.Hãy gửi yêu cầu từ máy chủ của bạn và tải chìa khóa từ một biến môi trường.
Gửi chìa khóa trong tiêu đề X-API-Key thông qua HTTPS. Cấu cốt URL cũng được hỗ trợ, nhưng URL có thể xuất hiện trong lịch sử và hồ sơ. Đừng bao giờ đặt chìa khóa bí mật của bạn trong hình ảnh QR hoặc ví dụ công cộng.
Làm thế nào để xử lý phản ứng
Một câu trả lời thành công chứa bản thân hình ảnh, không phải JSON với một liên kết tải xuống. kiểm tra tình trạng HTTP trước khi tiết kiệm. lỗi trả về JSON với một giải thích; đừng tiết kiệm nó như một PNG.
SVG là hữu ích cho các tài liệu in, trong khi PNG phù hợp với hình ảnh hàng ngày. Tránh tái tạo mã mỗi lần truy cập vào một trang không thay đổi: lưu và sử dụng lại tệp. tuân thủ giới hạn yêu cầu và Retry-After delay.
Những điều cần kiểm tra trước khi xuất bản
API xác nhận nhập nhưng không mã hóa hình ảnh hoàn thành. Điều này làm giảm việc xử lý, nhưng dòng công việc của bạn phải xử lý kiểm tra quét. Kiểm tra kết hợp thiết kế điển hình và khối lượng dữ liệu lớn nhất bạn mong đợi.
Để lại một khu vực yên tĩnh nhẹ ít nhất bốn mô-đun, tương phản tốt và kích thước đủ. quét bố trí in cuối cùng với một điện thoại. trang API chứa các thông số kỹ thuật và sẵn sàng để sử dụng PHP, JavaScript, Python và cURL ví dụ.
Nguồn và đọc thêm
Được chuẩn bị và duy trì bởi Umind. kiểm tra các khuyến nghị này trên bố trí cuối cùng và thiết bị mục tiêu của bạn.