Mulai cepat
API QR Cake memungkinkan pengguna QR Cake mengelola kode QR di akun mereka.
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.
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
| Tool | Izin | Fungsinya |
|---|---|---|
| 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_code | tidak ada | Merender teks atau URL apa pun menjadi gambar kode QR hitam di atas putih (PNG) atau markup SVG. Tidak ada yang disimpan. |
| build_qr_content | tidak ada | Mengodekan 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_design | tidak ada | Memperkirakan 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.
Tambahkan URL server sebagai konektor kustom di Claude, lalu masuk saat diminta.
claude mcp add --transport http qrcake https://api.qrcake.com/mcp
Lalu jalankan /mcp di Claude Code dan masuk.
{
"mcpServers": {
"qrcake": {
"url": "https://api.qrcake.com/mcp"
}
}
}{
"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.
x-api-key: YOUR_API_KEYhttps://api.qrcake.com/v1/product/api/product
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),
});Daftar kode QR
Menampilkan kode QR yang bisa diakses oleh API key.
x-api-key: <API Key>Accept: application/json
[
{
"accountId": "string",
"productId": "string",
"userId": "string",
"redirect": "string",
"state": "ACTIVE",
"metadata": {},
"createdAt": 0,
"updatedAt": 0
}
]{
"message": {}
}Products = kode QR.
Ambil satu kode QR
Mengambil satu kode QR.
- productId (string)
x-api-key: <API Key>Accept: application/json
{
"accountId": "string",
"productId": "string",
"userId": "string",
"redirect": "string",
"state": "ACTIVE",
"metadata": {},
"createdAt": 0,
"updatedAt": 0
}{
"message": {}
}Buat kode QR
Membuat produk kode QR baru.
x-api-key: <API Key>Content-Type: application/jsonAccept: application/json
{
"redirect": "https://example.com",
"metadata": {},
"state": "ACTIVE"
}{
"accountId": "string",
"productId": "string",
"userId": "string",
"redirect": "string",
"state": "ACTIVE",
"metadata": {},
"createdAt": 0,
"updatedAt": 0
}{
"message": {}
}Body request POST harus dikirim dalam bentuk string (misalnya, JSON.stringify(payload)).
Perbarui kode QR
Memperbarui kode QR (product) yang sudah ada.
- productId (string)
x-api-key: <API Key>Content-Type: application/jsonAccept: application/json
{
"redirect": "https://example.com",
"metadata": {},
"state": "ACTIVE"
}{
"accountId": "string",
"productId": "string",
"userId": "string",
"redirect": "string",
"state": "ACTIVE",
"metadata": {},
"expiresAt": 0,
"createdAt": 0,
"updatedAt": 0
}{
"message": {}
}Body request PUT harus dikirim dalam bentuk string.
Hapus kode QR
Menghapus satu kode QR.
- productId (string)
x-api-key: <API Key>Accept: application/json
{
"productId": "string"
}{
"message": {}
}Izin
Mengembalikan daftar izin yang dimiliki API key.
x-api-key: <API Key>Accept: application/json
{
"success": true,
"result": {
"tier": "subscriber",
"active": true,
"analytics": true,
"productLimit": 100,
"productTotal": 3,
"productActiveLimit": 100,
"productActiveTotal": 3
}
}{
"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.