Tài liệu API

    Tài liệu và hướng dẫn dành cho nhà phát triển để tích hợp QR Cake.

    JSON REST APITạo QR độngBearer Authorization

    Bắt đầu nhanh

    QR Cake API cho phép người dùng QR Cake quản lý các mã QR trong tài khoản của họ.

    URL gốc
    https://api.qrcake.com/v1/product

    Xác thực

    Tạo khóa API trong bảng điều khiển của bạn rồi gửi khóa đó trong tiêu đề Authorization.

    Authorization: Bearer <API Key>
    Content-Type: application/json

    Quản lý khóa API tại Khóa API trong bảng điều khiển.

    Trình kiểm tra yêu cầu API

    Kiểm tra trực tiếp các endpoint từ trang này. Nhập khóa API, chọn endpoint và xem phản hồi theo thời gian thực.

    Trình kiểm tra API tương tác

    Chạy yêu cầu trực tiếp từ trình duyệt của bạn tới endpoint QR Cake API đã chọn.

    GET
    Authorization: Bearer <API Key>
    URL thực thi
    https://api.qrcake.com/v1/product/user/product
    Chạy một yêu cầu để xem trạng thái trực tiếp và nội dung phản hồi tại đây.

    Thuật ngữ

    Các sản phẩm

    Mã QR

    Người dùng

    Tài khoản QR Cake

    Nội dung yêu cầu (POST/PUT)

    Với các yêu cầu POST và PUT, nội dung yêu cầu phải được chuyển thành chuỗi. Nếu bạn gửi JSON, hãy truyền một chuỗi JSON (ví dụ: JSON.stringify(payload)).

    const payload = { redirect: "https://example.com", metadata: {} };
    
    await fetch(url, {
      method: "POST",
      body: JSON.stringify(payload),
    });
    GET

    Danh sách mã QR

    Liệt kê các mã QR mà khóa API có thể truy cập.

    Mở trong GitBook
    Đường dẫn: /user/product
    URL: https://api.qrcake.com/v1/product/user/product
    Chi tiết yêu cầu
    Tiêu đề
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Phản hồi
    200 OK
    [
      {
        "accountId": "string",
        "productId": "string",
        "userId": "string",
        "redirect": "string",
        "state": "ACTIVE",
        "metadata": {},
        "createdAt": 0,
        "updatedAt": 0
      }
    ]
    401 Unauthorized
    {
      "message": {}
    }

    Products = Mã QR.

    GET

    Nhận mã QR

    Lấy một mã QR.

    Mở trong GitBook
    Đường dẫn: /product/{productId}
    URL: https://api.qrcake.com/v1/product/product/{productId}
    Chi tiết yêu cầu
    Thông số đường dẫn
    • productId (string)
    Tiêu đề
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Phản hồi
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }
    POST

    Tạo mã QR

    Tạo một sản phẩm mã QR mới.

    Mở trong GitBook
    Đường dẫn: /product
    URL: https://api.qrcake.com/v1/product/product
    Chi tiết yêu cầu
    Tiêu đề
    • Authorization: Bearer <API Key>
    • Content-Type: application/json
    • Accept: application/json
    Mẫu nội dung
    {
      "redirect": "https://example.com",
      "metadata": {},
      "state": "ACTIVE"
    }
    Phản hồi
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }

    POST nội dung yêu cầu phải được xâu chuỗi (ví dụ: JSON.stringify(payload)).

    PUT

    Cập nhật mã QR

    Cập nhật mã QR hiện có (sản phẩm).

    Mở trong GitBook
    Đường dẫn: /product/{productId}
    URL: https://api.qrcake.com/v1/product/product/{productId}
    Chi tiết yêu cầu
    Thông số đường dẫn
    • productId (string)
    Tiêu đề
    • Authorization: Bearer <API Key>
    • Content-Type: application/json
    • Accept: application/json
    Mẫu nội dung
    {
      "redirect": "https://example.com",
      "metadata": {},
      "state": "ACTIVE"
    }
    Phản hồi
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "expiresAt": 0,
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }

    PUT nội dung yêu cầu phải được xâu chuỗi.

    DELETE

    Xóa mã QR

    Xóa một mã QR.

    Mở trong GitBook
    Đường dẫn: /product/{productId}
    URL: https://api.qrcake.com/v1/product/product/{productId}
    Chi tiết yêu cầu
    Thông số đường dẫn
    • productId (string)
    Tiêu đề
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Phản hồi
    200 OK
    {
      "productId": "string"
    }
    401 Unauthorized
    {
      "message": {}
    }
    GET

    Quyền

    Trả về các quyền được cấp cho khóa API.

    Mở trong GitBook
    Đường dẫn: /permission
    URL: https://api.qrcake.com/v1/product/permission
    Chi tiết yêu cầu
    Tiêu đề
    • Authorization: Bearer <API Key>
    • Accept: application/json
    Phản hồi
    200 OK
    {
      "success": true,
      "result": {
        "analytics": true,
        "productLimit": 100,
        "tier": "subscriber",
        "productTotal": 3,
        "productActiveLimit": 100,
        "productActiveTotal": 3
      }
    }
    401 Unauthorized
    {
      "message": {}
    }

    Các loại QR được hỗ trợ

    Sử dụng các loại metadata này khi tạo hoặc cập nhật sản phẩm QR.

    redirect, link, image, video, file, pdf, audio, app, event, vCard

    Bắt đầu với mã QR độngmã QR có thể chỉnh sửa trên trang chủ của chúng tôi.