Tài liệu API

Tạo mã QR và mã vạch từ sản phẩm của bạn bằng REST API. Gửi JSON tới /api/v1, nhận hình SVG được lưu trữ, rồi liệt kê hoặc cập nhật cùng tài nguyên đó.

Tạo mã QR

POST /api/v1/qr-codes với type, nội dung và thiết kế tùy chọn: màu, kiểu module, logo, mắt và khung. Phản hồi gồm URL SVG được lưu trữ.

{
  "name": "Website QR",
  "type": "url",
  "url": "https://forqrcode.com",
  "style": "rounded",
  "size": 500,
  "ecc": "M",
  "foreground_color": "#17191c",
  "background_color": "#ffffff",
  "qr_code_logo": "https://forqrcode.com/logo.png",
  "qr_code_logo_size": 25
}
Tham chiếu tạo QR

Tạo mã vạch

POST /api/v1/barcodes với symbology, value và màu hoặc kích thước tùy chọn. Có ba mươi bốn loại, từ Code 128 đến EAN-13.

{
  "name": "Product SKU",
  "type": "C128",
  "value": "FORQR-1001",
  "foreground_color": "#17191c",
  "background_color": "#ffffff",
  "width_scale": 2,
  "height": 80,
  "display_text": true
}
Tham chiếu tạo mã vạch

Xác thực

Gửi khóa API dưới dạng Bearer trong mỗi yêu cầu. Xem hoặc tạo lại khóa tại Bảng điều khiển → Tài khoản → API.

Authorization: Bearer YOUR_API_KEY

URL cơ sở: https://forqrcode.com/api/v1

Giới hạn tốc độ

Mỗi khóa API giới hạn 60 yêu cầu/phút. Phản hồi có tiêu đề X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

Lỗi

Lỗi theo JSON:API:

{ "errors": [{ "title": "…", "status": "422" }] }

Lỗi xác thực có thể bao gồm source.pointer.