Dokumentasi API QR Code Dinamis

    Buat, perbarui, dan kelola kode QR dinamis dengan API QR Cake. Gunakan API key, uji request, dan hubungkan alur kerja QR ke tool yang Anda gunakan.

    REST API JSONPembuatan QR dinamisAutentikasi API keyServer MCP

    Mulai cepat

    API QR Cake memungkinkan pengguna QR Cake mengelola kode QR di akun mereka.

    Base URL
    https://api.qrcake.com/v1/product/api

    Autentikasi

    Buat API key di dasbor Anda, lalu kirimkan lewat header x-api-key.

    Setiap key membawa izin yang dipilih saat dibuat (baca kode QR, buat dan perbarui kode QR, baca analitik pemindaian), dan key lengkap hanya ditampilkan sekali.

    x-api-key: <API Key>
    Content-Type: application/json

    Kelola API key di API Key Dasbor.

    Panduan API QR Code: Membuat dan Mengelola Kode Secara Terprogram (2026)

    Server MCP untuk asisten AI

    QR Cake juga menjalankan server MCP (Model Context Protocol) jarak jauh, sehingga Claude, Claude Code, Cursor, dan VS Code bisa menampilkan, membuat, memperbarui, dan menghapus kode QR Anda dalam percakapan. Anda terhubung dengan masuk ke akun QR Cake Anda.

    URL server
    https://api.qrcake.com/mcp
    Metadata resource (RFC 9728)
    https://api.qrcake.com/.well-known/oauth-protected-resource/mcp

    Autentikasi

    Klien membuka halaman masuk QR Cake saat pertama kali terhubung. Masuk, lalu setujui apa yang boleh dilakukan klien. Tidak ada API key atau kata sandi yang dimasukkan ke klien; API key hanya berfungsi dengan REST API.

    Tool yang bisa dipanggil klien bergantung pada izin yang Anda setujui. Tiga tool yang tidak memerlukan izin selalu tersedia.

    codes.read

    Baca kode QR dan batas paket

    codes.write

    Buat, perbarui, dan hapus kode QR

    analytics.read

    Baca analitik pemindaian (paket Pro dan Business)

    Tool

    ToolIzinFungsinya
    list_qr_codes
    codes.read
    Menampilkan semua kode QR milik Anda beserta short link, tujuan, dan statusnya.
    get_qr_code
    codes.read
    Mengambil satu kode QR Anda berdasarkan id.
    get_plan_limits
    codes.read
    Tingkat paket Anda, jumlah kode dan kode aktif yang terpakai dibanding batasnya, apakah analitik termasuk, dan batas domain kustom.
    create_qr_code
    codes.write
    Membuat kode QR dinamis yang short link-nya mengarahkan ke URL yang diberikan; batas paket Anda berlaku.
    update_qr_code
    codes.write
    Mengubah tujuan, status, metadata, atau opsi kode QR tanpa mencetak ulang; field yang tidak diisi tetap nilainya.
    create_file_upload
    codes.write
    Menyiapkan unggahan file (gambar, PDF, audio, atau video) untuk dilampirkan ke kode QR. Klien mengunggah sendiri file tersebut.
    delete_qr_code
    codes.write
    Menghapus kode QR secara permanen; salinan cetaknya berhenti berfungsi.
    design_qr_code
    codes.read
    codes.write
    Membuka desainer interaktif untuk salah satu kode QR Anda, tempat Anda bisa mengubah bentuk, warna, logo, dan bingkainya, lalu menyimpannya.
    get_qr_code_analytics
    analytics.read
    Analitik pemindaian untuk satu kode QR (interaksi, lokasi, perangkat, atau geo, per minggu, bulan, atau tahun). Butuh paket dengan analitik.
    render_qr_codetidak adaMerender teks atau URL apa pun menjadi gambar kode QR hitam di atas putih (PNG) atau markup SVG. Tidak ada yang disimpan.
    build_qr_contenttidak adaMengodekan kredensial WiFi, kartu kontak, email, SMS, panggilan, acara kalender, lokasi, pembayaran kripto, tautan WhatsApp, peta, atau FaceTime menjadi teks yang harus dibawa kode QR.
    analyze_qr_designtidak adaMemperkirakan seberapa banyak tiap blok koreksi error terpakai oleh desain bergaya (warna, gaya modul, logo), dengan vonis: sehat, rapuh, kritis, atau melebihi batas.

    Hubungkan klien

    Claude, Claude Code, Cursor, dan VS Code bisa terhubung. Klien lain belum diterima.

    Claude

    Tambahkan URL server sebagai konektor kustom di Claude, lalu masuk saat diminta.

    Claude Code
    claude mcp add --transport http qrcake https://api.qrcake.com/mcp

    Lalu jalankan /mcp di Claude Code dan masuk.

    Cursor (mcp.json)
    {
      "mcpServers": {
        "qrcake": {
          "url": "https://api.qrcake.com/mcp"
        }
      }
    }
    VS Code (mcp.json)
    {
      "servers": {
        "qrcake": {
          "type": "http",
          "url": "https://api.qrcake.com/mcp"
        }
      }
    }
    • Analitik pemindaian termasuk dalam paket Pro dan Business; di paket gratis, get_qr_code_analytics membalas dengan error.
    • Kode yang dibuat lewat MCP dihitung terhadap batas paket Anda persis seperti kode yang dibuat di dasbor.
    • Kode file, PDF, gambar, video, dan audio butuh unggahan. Klien yang bisa mengirim permintaan web, seperti Claude Code atau Cursor, bisa mengunggah file dengan create_file_upload; jika tidak, buat kode tersebut di dasbor.
    • Di klien yang mendukung MCP Apps, seperti Claude, design_qr_code membuka desainer langsung di dalam percakapan. Klien lain menerima kode tersebut dalam format JSON.
    • Koneksi berlaku hingga 30 hari, setelah itu klien meminta Anda masuk lagi.

    Penguji request API

    Uji endpoint langsung dari halaman ini. Masukkan API key Anda, pilih endpoint, lalu periksa response yang dikembalikan.

    Penguji API interaktif

    Jalankan request langsung dari browser Anda ke endpoint API QR Cake yang dipilih.

    GET
    x-api-key: YOUR_API_KEY
    URL akhir
    https://api.qrcake.com/v1/product/api/product
    Jalankan request untuk melihat status dan isi response di sini.

    Terminologi

    Products

    Kode QR

    Users

    Akun QR Cake

    Body request (POST/PUT)

    Untuk request POST dan PUT, body harus dikirim dalam bentuk string. Jika Anda mengirim JSON, kirimkan sebagai string JSON (misalnya JSON.stringify(payload)).

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

    Daftar kode QR

    Menampilkan kode QR yang bisa diakses oleh API key.

    Buka di GitBook
    Path: /product
    URL: https://api.qrcake.com/v1/product/api/product
    Detail request
    Header
    • x-api-key: <API Key>
    • Accept: application/json
    Response
    200 OK
    [
      {
        "accountId": "string",
        "productId": "string",
        "userId": "string",
        "redirect": "string",
        "state": "ACTIVE",
        "metadata": {},
        "createdAt": 0,
        "updatedAt": 0
      }
    ]
    401 Unauthorized
    {
      "message": {}
    }

    Products = kode QR.

    GET

    Ambil satu kode QR

    Mengambil satu kode QR.

    Buka di GitBook
    Path: /product/{productId}
    URL: https://api.qrcake.com/v1/product/api/product/{productId}
    Detail request
    Parameter path
    • productId (string)
    Header
    • x-api-key: <API Key>
    • Accept: application/json
    Response
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }
    POST

    Buat kode QR

    Membuat produk kode QR baru.

    Buka di GitBook
    Path: /product
    URL: https://api.qrcake.com/v1/product/api/product
    Detail request
    Header
    • x-api-key: <API Key>
    • Content-Type: application/json
    • Accept: application/json
    Template body
    {
      "redirect": "https://example.com",
      "metadata": {},
      "state": "ACTIVE"
    }
    Response
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }

    Body request POST harus dikirim dalam bentuk string (misalnya, JSON.stringify(payload)).

    PUT

    Perbarui kode QR

    Memperbarui kode QR (product) yang sudah ada.

    Buka di GitBook
    Path: /product/{productId}
    URL: https://api.qrcake.com/v1/product/api/product/{productId}
    Detail request
    Parameter path
    • productId (string)
    Header
    • x-api-key: <API Key>
    • Content-Type: application/json
    • Accept: application/json
    Template body
    {
      "redirect": "https://example.com",
      "metadata": {},
      "state": "ACTIVE"
    }
    Response
    200 OK
    {
      "accountId": "string",
      "productId": "string",
      "userId": "string",
      "redirect": "string",
      "state": "ACTIVE",
      "metadata": {},
      "expiresAt": 0,
      "createdAt": 0,
      "updatedAt": 0
    }
    401 Unauthorized
    {
      "message": {}
    }

    Body request PUT harus dikirim dalam bentuk string.

    DELETE

    Hapus kode QR

    Menghapus satu kode QR.

    Buka di GitBook
    Path: /product/{productId}
    URL: https://api.qrcake.com/v1/product/api/product/{productId}
    Detail request
    Parameter path
    • productId (string)
    Header
    • x-api-key: <API Key>
    • Accept: application/json
    Response
    200 OK
    {
      "productId": "string"
    }
    401 Unauthorized
    {
      "message": {}
    }
    GET

    Izin

    Mengembalikan daftar izin yang dimiliki API key.

    Buka di GitBook
    Path: /permission
    URL: https://api.qrcake.com/v1/product/api/permission
    Detail request
    Header
    • x-api-key: <API Key>
    • Accept: application/json
    Response
    200 OK
    {
      "success": true,
      "result": {
        "tier": "subscriber",
        "active": true,
        "analytics": true,
        "productLimit": 100,
        "productTotal": 3,
        "productActiveLimit": 100,
        "productActiveTotal": 3
      }
    }
    401 Unauthorized
    {
      "message": {}
    }

    Tipe QR yang didukung

    Gunakan tipe metadata berikut saat membuat atau memperbarui produk QR.

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

    Mulai dengan kode QR dinamis dan kode QR yang bisa diubah di beranda kami.