API Trình Tạo Mã QR

Tạo hình ảnh mã QR bằng cách thêm .qr.png vào bất kỳ liên kết rút gọn Linkly nào. Không cần xác thực hoặc khóa API.

Hình ảnh được trả về dưới dạng PNG với tất cả các kiểu mã QR đã lưu được áp dụng, bao gồm màu sắc tùy chỉnh, hoa văn dấu chấm, kiểu mắt và logo.

Cách sử dụng cơ bản

Thêm .qr.png vào bất kỳ liên kết rút gọn Linkly nào:

https://linkly.link/2W6Z9.qr.png

Điều này trả về hình ảnh PNG 1024x1024 của mã QR. Nếu bạn đã tùy chỉnh màu sắc, kiểu dáng hoặc logo của mã QR trong Linkly, những kiểu dáng đó sẽ được áp dụng tự động.

Ví dụ

Nhúng mã QR vào trang HTML:

<img src="https://linkly.link/2W6Z9.qr.png" alt="QR Code" />

Hoặc sử dụng nó trong mẫu email, PDF hoặc bất kỳ hệ thống nào hỗ trợ URL hình ảnh.

Tham số kiểu dáng

Truyền các tham số truy vấn để ghi đè các kiểu QR đã lưu của liên kết hoặc thay đổi kích thước hình ảnh:

https://linkly.link/2W6Z9.qr.png?qrStyle=dots&fgColor=%23009eff&size=2048

Lưu ý: các màu hex phải được mã hóa URL — sử dụng %23 thay cho # (ví dụ: %23ff0000 cho #ff0000).

Kích thước logo được tự động chia tỷ lệ để phù hợp với kích thước hình ảnh được yêu cầu.

quietZone thêm khoảng trắng xung quanh toàn bộ mã QR, được điền bằng bgColor. Điều này hữu ích khi in mã QR trên nền tối — nếu không có nó, các mắt định vị sẽ sát mép và có thể không quét được đáng tin cậy. Ví dụ: quietZone=50&bgColor=%23ffffff thêm đường viền trắng 50 pixel.

Đặt kiểu dáng qua API liên kết

Bạn có thể lưu các kiểu mã QR vào một liên kết khi tạo hoặc cập nhật nó qua API Rút Gọn Liên Kết. Truyền một đối tượng JSON qr_styles với bất kỳ khóa kiểu dáng nào được liệt kê ở trên:

{
  "api_key": "your_api_key",
  "workspace_id": 1234,
  "url": "https://example.com",
  "qr_styles": {
    "fgColor": "#009eff",
    "bgColor": "#ffffff",
    "qrStyle": "dots",
    "eyeStyle": "rounded",
    "logoImage": "https://example.com/logo.png",
    "logoWidth": 60,
    "logoHeight": 60,
    "logoPadding": 10,
    "logoStyle": "circle",
    "quietZone": 50
  }
}

Sau khi lưu, những kiểu dáng này sẽ được áp dụng tự động bất cứ khi nào bạn yêu cầu hình ảnh .qr.png — không cần tham số truy vấn.

Cách áp dụng kiểu dáng

Các kiểu mã QR được phân giải theo thứ tự sau:

1. 1
   Kiểu dáng mặc định — Nền trước đen trên nền trong suốt, mô-đun vuông, 1024px
2. 2
   Kiểu dáng đã lưu — Bất kỳ tùy chỉnh nào bạn đã thực hiện trong trình chỉnh sửa mã QR hoặc đặt qua API Liên kết sẽ được lưu trữ với liên kết
3. 3
   Ghi đè tham số truy vấn — Ghi đè các kiểu dáng riêng lẻ theo mỗi yêu cầu qua tham số URL

Khi có logo, Linkly tự động sử dụng sửa chữa lỗi cao (Mức H) để đảm bảo mã QR vẫn có thể quét được.

Giới hạn tỷ lệ

Điểm cuối được giới hạn tỷ lệ ở 5 yêu cầu mỗi giây trên mỗi địa chỉ IP. Hình ảnh được lưu trong bộ nhớ đệm trong 5 phút, vì vậy các yêu cầu lặp lại cho cùng một mã QR sẽ được phục vụ nhanh chóng.

Phản hồi

Một yêu cầu thành công trả về trạng thái 200 có Content-Type: image/png và dữ liệu hình ảnh PNG làm phần nội dung phản hồi.

Phản hồi lỗi trả về JSON:

{"error": "Rate limit exceeded"}

Tài nguyên liên quan

• Tạo Mã QR - Cách tạo và tùy chỉnh mã QR trong Linkly
• Thêm Logo vào Mã QR - Tạo mã QR thương hiệu với logo công ty của bạn
• Mã QR SVG - Tải xuống mã QR ở định dạng vectơ có thể mở rộng
• API Rút Gọn Liên Kết - Tạo và quản lý liên kết theo chương trình
• API Phân Tích - Xuất dữ liệu nhấp chuột và báo cáo lưu lượng truy cập