QRFLOW.codes

resmi

QR kodları oluşturun, basılı dinamik kodları yeniden yönlendirin, kendi alan adınızda bağlantıları adlandırın ve tarama analizlerini okuyun.

QRFLOW Codes MCP ile neler yapabilirsiniz?

  • Dinamik QR kodları oluşturun — Asistandan destination_data ile bir url kodu oluşturmasını ve yazdırmak için short_url değerini döndürmesini isteyin.
  • Yazdırılmış bir kodun yönlendirmesini değiştirin — Görsel short_url değerini içerdiğinden, yeniden yazdırmadan mevcut bir dinamik kodun yönlendirdiği yeri değiştirin.
  • Bir kodu duraklatın veya süresini doldurun — Silmek yerine paused: true ayarlayın veya bir bitiş tarihi belirleyin; böylece yazdırılmış bir bağlantı güvenli şekilde yönlendirmeyi durdurur.
  • Tarama analizlerini görüntüleyin — Bir kod için toplam Scans sayısını veya gün, ülke ve cihaz başına dökümü alın.
  • Bağlantıları kendi alan adınızda adlandırın — menu gibi bir slug belirleyin ve kodun go.example.com/menu olarak yazdırılması için bir bağlantı alan adı seçin.
  • Toplu kod oluşturun — Bir listeden binlerce dinamik kod oluşturun ve döndürülen kodları etiketlerine göre satırlarla eşleştirin.

Barındırılan MCP Sunucusu

npx add-mcp 'https://qrflow.codes/mcp'

Claude Code, Codex, Cursor ve daha fazlasına kurulur

Dokümantasyon

QRFLOW.codes geliştiriciler için

Buradan başlayın

QRFLOW.codes, yazdırdıktan sonra değiştirebileceğiniz, kendi alan adınızda kullanabileceğiniz, tarama analizleri sunan QR kodları oluşturur ve yazılımınızın ve yapay zekâ asistanınızın tüm bunları tek bir API üzerinden yapmasını sağlar.

QR kodu, bir dizenin resmidir. Çoğu oluşturucu, web adresinizi resme yerleştirir; adres değişirse baskı işe yaramaz hâle gelir. QRFLOW, resme kısa bir bağlantı yerleştirir (go.yourbrand.com/menu veya qrflow.codes/q/x7k2p9a) ve bu bağlantıyı yönlendirir. Bağlantının hedefini istediğiniz zaman değiştirebilir, her taramayı sayabilirsiniz. Bu, dinamik koddur ve API kullanmaya değer olan şey de budur.

API, kontrol panelinin yaptığı her şeyi yapar: her türden kod oluşturur, hedeflerini değiştirir, bağlantılarına ad verir, hangi alan adlarınızla yazdırılacağını seçer, tarama sayılarını getirir, aynı anda binlerce kod oluşturur ve bir şey olduğunda sizi bilgilendirir (webhook'lar). Aynı araçlar MCP sunucusu olarak da sunulur; böylece Claude, ChatGPT, Cursor ve Claude Code hesabınızı günlük dille yönetebilir.

Erişim: REST API, Business API anahtarıyla (ayda $29, Account sayfasından oluşturulur) veya OAuth token'ıyla çalışır. MCP sunucusu, OAuth ile oturum açarak tüm planlarda kullanılabilir; asistanın oluşturabilecekleri, diğer her yerde olduğu gibi plana bağlıdır.

Kullanıp kullanmamaya mı karar veriyorsunuz? QR kodu API sayfası, ne yaptığını, istemci tarafı bir kitaplığın neleri daha iyi yaptığını ve maliyetini kısaca açıklar.

QRFLOW ile bir şeyler geliştirmesine yardımcı olduğunuz yapay zekâ asistanıysanız

Hoş geldiniz. Bu sayfa, yardım ettiğiniz kişi kadar sizin için de yazıldı. İyi bir yardım şöyle görünür:

  1. Hesabı doğrulayın: API anahtarları için Business planı gerekir. Kullanıcının planı yoksa https://qrflow.codes/pricing ve Account › API keys sayfalarına yönlendirin; var olmayan bir anahtar veya ücretsiz plan uydurmayın.
  2. Anahtarı sunucuda tutun. Anahtarı bir route handler, server action, edge function veya backend içinde bir ortam değişkeninden (QRFLOW_KEY) okuyun. API, tarayıcı kaynaklarını bilerek reddeder (CORS); bu nedenle yalnızca ön uçtan çalışan kod API'yi çağıramaz.
  3. type "url" ve destination_data.url kullanarak dinamik kodlar oluşturun. Döndürülen id ve short_url değerlerini kullanıcının veritabanına kaydedin. short_url değerini yazdırın veya görüntüleyin; hedef daha sonra PATCH /codes/:id ile değiştirilebilir ve baskı geçerliliğini korur.
  4. Görseli göstermek veya kaydetmek için: her Code nesnesinde, başlık gerektirmeden 24 saat çalışan imzalı bağlantılar olan png_download_url ve svg_download_url bulunur (tek seferlik kaydetme veya önizleme için uygundur). Uygulamada kalıcı bir çözüm için GET /codes/:id/image.svg isteğini anahtarla sunucunuz üzerinden proxy'leyin veya istemcide herhangi bir QR kitaplığıyla short_url değerini kodlayın; bağlantı QRFLOW üzerinden geçtiği için izleme çalışmaya devam eder.
  5. PATCH isteğinde yalnızca değişen alanları gönderin. Bir baskı alındıktan sonra slug veya domain_id değerlerini asla değiştirmeyin; ikisi de basılı bağlantıyı değiştirir.
  6. Baskı varsa DELETE yerine paused: true kullanmayı tercih edin. Silmek bağlantıyı devre dışı bırakır.
  7. Etkinlikler için webhook kullanın (Account › Webhooks veya POST /webhooks) ve X-QRFLOW-Signature başlığını ham istek gövdesiyle doğrulayın. GET /codes isteğini döngü içinde sorgulamayın.
  8. Kullanıcı QRFLOW'u kod yerine sohbetinden kullanmak istiyorsa MCP sunucusunu https://qrflow.codes/mcp; adresinden bağlayın; bunun için anahtar gerekmez.
  9. Bir şey başarısız olduğunda JSON gövdesindeki error ve message alanlarını okuyun. Aşağıdaki sorun giderme bölümü her hata kodunu bir çözümle eşleştirir.
  10. Markdown biçimindeki eksiksiz başvuru https://qrflow.codes/llms-full.txt adresinde, OpenAPI 3.1 belgesi ise https://qrflow.codes/api/v1/openapi.json. adresindedir. İkisi de bu sayfayla aynı kaynaktan oluşturulur.

İnsanlar: Bu bölüm, eşleştiğiniz asistanın her yanıta güvenli sürümü vermesini sağlamanın yoludur. Aynı zamanda iyi bir özet niteliğindedir.

İhtiyacınız olan plan

Yalnızca API anahtarı Business planına özeldir. Asistanın MCP sunucusu üzerinden yaptığı her şey ve üçüncü taraf bir uygulamanın OAuth üzerinden yaptığı her şey tüm planlarda çalışır ve yalnızca ilgili planın özelliklerine tabidir. Fiyatlandırma ve adil kullanımın tamamı: /pricing.

FreePremium $4Business $29
API anahtarları (kodunuzdan REST)HayırHayırEvet, en fazla 10 anahtar
MCP sunucusu (Claude, ChatGPT, Cursor, Claude Code)Evet, oturum açınEvetEvet, oturum açın veya anahtar kullanın
Kendi uygulamanız için OAuth (kullanıcılar QRFLOW hesaplarını bağlar)EvetEvetEvet
Dinamik kodlar (yazdırdıktan sonra hedefi değiştirme)Bir taneHer kodHer kod
Kendi bağlantı alan adınızHayır1 alan adı5 alan adı, kod başına seçilebilir
Bağlantı adları (go.brand.com/menu)HayırEvetEvet
Tarama analizleriHayırEvetEvet
Webhook'larHayırHayırEvet, en fazla 10
Toplu oluşturmaHayırAyda 500, istek başına 500Ayda 10.000, istek başına 2.000
Kaydedilmiş kodlar (adil kullanım)Birkaç tane1.00025.000
Ekip üyeleri115
Fiyat$0$4/ay$29/ay

Her şeyi anlatan on iki kelime

Kavramlar

Bunları bir kez okuyun; aşağıdaki tüm uç noktalar anlaşılır hâle gelecektir.

Static code

İçerik resmin içindedir. Wi-Fi, kişi kartı (vCard) ve düz metin kodları her zaman statiktir; Free planında ise tüm kodlar statiktir. Statik kod için sunucu gerekmez, kodun süresi asla dolmaz ve kod değiştirilemez veya sayılmaz.

Dynamic code

Resimde, QRFLOW'un yönlendirdiği kısa bir bağlantı bulunur. url, phone, email, sms ve location kodları Premium ve Business planlarında dinamiktir. Baskıya dokunmadan hedeflerini değiştirebilir, duraklatabilir, sürelerini doldurabilir, yeniden adlandırabilir ve sayabilirsiniz.

short_url

Dinamik kodda kodlanan ve yazdırılması gereken tam dize. Alan adı bağlayana kadar https://qrflow.codes/q/<short_code>, alan adı bağlandıktan sonra https://<your domain>/<slug or short_code>. olur. Her Code nesnesinde bulunur.

short_code

Her kod için benzersiz olan, oluşturulurken atanan ve bir daha değişmeyen yedi rastgele karakter. Kodun bağlantı adı yoksa kullanılan yedek yol.

slug (link name)

Kendi alan adınızdaki okunabilir bir yol: go.example.com/menu. 3 ila 40 küçük harf, rakam ve tire; hesabınızda benzersiz olmalı ve yalnızca bağlı bir alan adıyla kullanılabilir. Yazdırmadan önce ayarlayın: değiştirmek, basılı bağlantıyı değiştirir.

Link domain

Sahip olduğunuz ve CNAME ile QRFLOW'a yönlendirilmiş, Account sayfasında doğrulanmış bir ana makine adı (go.example.com). Premium bir alan adı alır; Business beş alan adı alır ve domain_id ile kod başına seçim yapabilir. Etkin durumdaki en eski alan adı varsayılandır.

Kind, type and subtype

type, kodlamayı belirtir: url, text, wifi, vcard, email, phone, sms, location. Tür, kullanıcıların istediği şey için daha anlaşılır bir addır (instagram, googlereview, whatsapp, pdf, menu, appstore,...). Çoğu tür, destination_data.subtype ayarlanmış url kodlarıdır. GET /catalog, her türü alanlarıyla listeler; Code üzerindeki kind ise kodun hangi türde olduğunu belirtir.

destination_data

Türün alanları, dize olarak: bir web sitesi için { url }, Wi-Fi için { ssid, password, encryption }, Google yorumu için { placeId }, Instagram için { handle }. Dinamik bir kodda bunları istediğiniz zaman değiştirebilirsiniz.

Scans

Her yönlendirme; istekten alınan cihaz türü, ülke, şehir, yönlendiren, tarayıcı, işletim sistemi ve dili, ayrıca benzersiz ziyaretçileri saymak için günlük tek yönlü bir hash kaydeder. Çerez ayarlanmaz ve IP adresi saklanmaz. Code üzerindeki scans, toplam yaşam boyu tarama sayısıdır; GET /codes/:id/scans bu sayıyı ayrıntılı olarak gösterir.

Source

Her kod, nasıl oluşturulduğunu hatırlar: dashboard, api:<key name>, mcp, canva, app:<connected app> (örneğin app:Google Sheets) veya bulk; toplu istekle oluşturulduysa bulk: öneki eklenir. Bu bilgi kontrol panelinde ve webhook yüklerinde görünür; böylece entegrasyonunuzun oluşturduğu kodları elle oluşturulanlardan ayırt edebilirsiniz.

Workspace

Business hesabının sahibi en fazla dört ekip arkadaşını davet edebilir. Anahtarlar ve webhook'lar sahibin hesabına aittir; çalışma alanındaki herkesin oluşturduğu kodlar tüm ekip tarafından görülebilir.

Beş dakika

Hızlı başlangıç

Anahtar alın

  1. Business planında, Account › API keys sayfasını açın.
  2. Anahtara kullanım amacını belirten bir ad verin ("Shop backend", "Reporting") ve kapsamlarını seçin. Kapsamlar sonradan değiştirilemez; daha fazlasına ihtiyacınız olursa yeni bir anahtar oluşturun.
  3. Anahtarı bir kez kopyalayın. Şu biçimdedir: qrf_live_…. Anahtarı QRFLOW_KEY adlı bir ortam değişkenine koyun.
  4. Her istekte Authorization: Bearer $QRFLOW_KEY olarak gönderin. Kimlik doğrulama bundan ibarettir.

Anahtarlar sunucular içindir. Bir web sayfasına, mobil uygulamaya veya paylaşılan e-tabloya asla koymayın; sızarsa iptal edip yenisini oluşturun.

Aynı beş adım curl, TypeScript ve Python ile. Her örnek dinamik bir kod oluşturur, görselini indirir, hedefini değiştirir ve taramalarını okur.

export QRFLOW_KEY=qrf_live_...   # from Account › API keys

# 1. Who am I, what can this key do?
curl https://qrflow.codes/api/v1/me -H "Authorization: Bearer $QRFLOW_KEY"

# 2. Make a dynamic code. Print what comes back as short_url.
curl -X POST https://qrflow.codes/api/v1/codes \
  -H "Authorization: Bearer $QRFLOW_KEY" -H "Content-Type: application/json" \
  -d '{ "type": "url", "destination_data": { "url": "https://example.com/menu" }, "label": "Table tents" }'

# 3. The print-ready image (SVG, with your colors and frame).
curl "https://qrflow.codes/api/v1/codes/$CODE_ID/image.svg?size=1024" \
  -H "Authorization: Bearer $QRFLOW_KEY" -o menu.svg

# 4. Fall menu. The printed code keeps working.
curl -X PATCH https://qrflow.codes/api/v1/codes/$CODE_ID \
  -H "Authorization: Bearer $QRFLOW_KEY" -H "Content-Type: application/json" \
  -d '{ "destination_data": { "url": "https://example.com/menu-fall" } }'

# 5. How did it do?
curl "https://qrflow.codes/api/v1/codes/$CODE_ID/scans?group=day" -H "Authorization: Bearer $QRFLOW_KEY"

TypeScript (Node 18+, Bun, Deno, Workers)

// npm install qrflow   (zero dependencies; ESM + CommonJS; full types)
import { QRFlow, QRFlowError } from "qrflow";

const qr = new QRFlow(process.env.QRFLOW_KEY!);

const { code } = await qr.createCode({
  type: "url",
  destination_data: { url: "https://example.com/menu" },
  label: "Table tents",
});
console.log(code.id, code.short_url);        // save both; print short_url

await qr.updateCode(code.id, { destination_data: { url: "https://example.com/menu-fall" } });

const stats = await qr.scans(code.id, { group: "day" });
console.log(stats.total, stats.rows);         // [{ key: "2026-09-21", scans: 18 }, ...]

try {
  await qr.updateCode(code.id, { slug: "menu" });
} catch (e) {
  if (e instanceof QRFlowError) console.log(e.status, e.code, e.message); // 400 no_domain: connect a domain first
}
# Download https://qrflow.codes/sdk/qrflow.py next to your code.
import os
from qrflow import QRFlow, QRFlowError

qr = QRFlow(os.environ["QRFLOW_KEY"])

code = qr.create_code(type="url", destination_data={"url": "https://example.com/menu"}, label="Table tents")["code"]
print(code["id"], code["short_url"])          # save both; print short_url

qr.update_code(code["id"], destination_data={"url": "https://example.com/menu-fall"})

stats = qr.scans(code["id"], group="day")
print(stats["total"], stats["rows"])

try:
    qr.update_code(code["id"], slug="menu")
except QRFlowError as e:
    print(e.status, e.code, e)                # 400 no_domain: connect a domain first

Kimlik doğrulama

API anahtarları (Business)

Hesap başına en fazla 10 anahtar, her biri dakikada 600 istek; anahtarlar hash'lenmiş olarak saklanır ve yalnızca bir kez gösterilir. Anahtar, oluşturulurken seçilen kapsamları taşır:

Kapsamİzin verilenler
profileGET /me: plan, özellikler, sınırlar. Her anahtarda bulunur.
codes:readKodları listeleme ve okuma, görselleri indirme.
codes:writeKod oluşturma, değiştirme, dinamik hâle getirme, silme ve toplu oluşturma.
analytics:readGET /codes/:id/scans.
domains:readGET /domains (domain_id değerini doğru kullanmak için gereklidir).
codes:read / codes:writeGS1 ürünleri de: /products uç noktaları kod kapsamlarını paylaşır; dolayısıyla kodları yöneten bir anahtar ambalaj kodlarını da yönetir.
webhooks:manageWebhook'ları listeleme, oluşturma, test etme ve silme.

OAuth 2.0 (her plan, uygulamalar ve asistanlar için)

Kodlar sizin hesabınız yerine kullanıcılarınızın hesaplarına ait olmalıysa veya istemci bir sohbet asistanıysa OAuth kullanın. İstemciler kendileri kaydolur; herkese açık istemciler için PKCE S256 zorunludur; token'lar MCP sunucusuna resource= ile bağlanabilir. OAuth kılavuzu adım adım açıklar.

Uç noktaURLNotlar
Yetkilendirmehttps://qrflow.codes/oauth/authorizeKullanıcıyı buraya gönderin; oturum açıp Allow düğmesine basar.
Tokenhttps://qrflow.codes/api/oauth/tokenauthorization_code ve refresh_token grant türleri. Erişim token'ları 1 saat, yenileme token'ları 90 gün geçerlidir.
İptalhttps://qrflow.codes/api/oauth/revokeRFC 7009. Kullanıcılar Account › Connected apps sayfasından da bağlantıyı kesebilir.
İstemci kaydetmehttps://qrflow.codes/api/oauth/registerRFC 7591 dinamik kaydı; hesap gerekmez. Herkese açık istemciler dyn_ client_id alır ve PKCE S256 kullanmalıdır.
Keşifhttps://qrflow.codes/.well-known/oauth-authorization-serverRFC 8414. MCP kaynak belgesi /.well-known/oauth-protected-resource adresindedir.

Erişim token'ları 1 saat, yenileme token'ları 90 gün geçerlidir. Kullanıcılar bağlı uygulamaları Account › Connected apps sayfasında görür ve istedikleri zaman bağlantıyı kesebilir. https://qrflow.codes/mcp için oluşturulan token, /api/v1 üzerinde reddedilir; tersi de geçerlidir.

İnsanların gerçekten istediği şeyler

Geliştirme tarifleri

Her tarif eksiksizdir ve çalışan koddan doğrudan alınmıştır. Teknoloji yığınınıza uygun olanı seçin; yapı her zaman aynıdır: anahtarla sunucu tarafında çağrı yapın, id ve short_url değerlerini kaydedin, görseli gösterin.

Next.js: kod oluşturan bir route ve kodu gösteren bir route

Ne zaman kullanılır: Next.js uygulamanız (App Router) varsa ve QR kodu oluşturan bir düğme ile kodu görüntüleyen bir sayfa istiyorsanız.

  1. Anahtarınızı .env.local dosyasına QRFLOW_KEY olarak koyun. Asla NEXT_PUBLIC_ öneki eklemeyin.
  2. Kodu oluşturan ve id ile short_url döndüren bir POST route handler ekleyin.
  3. Tarayıcının anahtarı görmemesi için görseli proxy'leyen bir GET route ekleyin.
  4. id ve short_url değerlerini kendi kaydınızda (sipariş, masa, ürün, etkinlik) saklayın.
import { NextResponse } from "next/server";

export async function POST(req: Request) {
  const { url, label } = await req.json();
  const r = await fetch("https://qrflow.codes/api/v1/codes", {
    method: "POST",
    headers: { Authorization: \`Bearer ${process.env.QRFLOW_KEY}\`, "Content-Type": "application/json" },
    body: JSON.stringify({ type: "url", destination_data: { url }, label }),
  });
  const data = await r.json();
  if (!r.ok) return NextResponse.json(data, { status: r.status }); // { error, message }
  return NextResponse.json({ id: data.code.id, short_url: data.code.short_url });
}
// Proxies the SVG so the key stays on the server. Check that the signed-in
// user owns this id before you serve it, or anyone with an id can fetch it.
export async function GET(_: Request, { params }: { params: Promise<{ id: string }> }) {
  const { id } = await params;
  const r = await fetch(\`https://qrflow.codes/api/v1/codes/${id}/image.svg?size=1024\`, {
    headers: { Authorization: \`Bearer ${process.env.QRFLOW_KEY}\` },
  });
  return new Response(r.body, {
    status: r.status,
    headers: { "Content-Type": "image/svg+xml", "Cache-Control": "private, max-age=3600" },
  });
}
<img src={\`/api/qr/${code.id}/image\`} alt={\`QR code for ${code.label}\`} width={256} height={256} />
<a href={code.short_url}>{code.short_url}</a>
  • Server Actions da aynı şekilde çalışır: anahtarı action içinde kullanarak fetch çağrısı yapın.
  • Pages Router için aynı kodu pages/api/qr.ts dosyasına, req/res ile birlikte ekleyin.

Proxy kullanmadan QR'ı gösterin: short_url değerini kendiniz oluşturun

Ne zaman: Görseli tarayıcıda hemen göstermek istiyorsanız ve üzerinde QRFLOW'un çerçevelerine veya logosuna ihtiyacınız yoksa.

Kod kısa bağlantının kendisi OLDUĞUNDAN herhangi bir QR kitaplığı iş görür

import QRCode from "qrcode"; // npm i qrcode

// short_url came back from POST /codes. Encode it as-is.
const dataUrl = await QRCode.toDataURL(code.short_url, { width: 512, margin: 2 });
// <img src={dataUrl} />  scans go through QRFLOW, so analytics and re-pointing still work.
  • Önizleme için en hızlı yol budur. Baskı için /codes/:id/image.svg dosyasını indirin: kaydedilmiş renkleri, çerçeveyi, açıklamaları ve logoyu içerir ve vektör biçimindedir.
  • Daha sonra slug veya domain_id değerini değiştirirseniz short_url değişir; yeniden oluşturun.

Express veya herhangi bir Node sunucusu

Ne zaman: Basit bir Node arka ucu.

import express from "express";
const app = express();
app.use(express.json());
const H = { Authorization: \`Bearer ${process.env.QRFLOW_KEY}\`, "Content-Type": "application/json" };

app.post("/qr", async (req, res) => {
  const r = await fetch("https://qrflow.codes/api/v1/codes", {
    method: "POST", headers: H,
    body: JSON.stringify({ type: "url", destination_data: { url: req.body.url }, label: req.body.label }),
  });
  res.status(r.status).json(await r.json());
});

app.get("/qr/:id.svg", async (req, res) => {
  const r = await fetch(\`https://qrflow.codes/api/v1/codes/${req.params.id}/image.svg\`, { headers: H });
  res.status(r.status).type("image/svg+xml").send(await r.text());
});

app.listen(3000);

Cloudflare Workers, Vercel Edge, Deno Deploy, Supabase Edge Functions

Ne zaman: Node yerleşik modüllerini kullanmayan, yalnızca fetch destekli bir çalışma zamanı.

export default {
  async fetch(req: Request, env: { QRFLOW_KEY: string }) {
    const { url, label } = await req.json();
    const r = await fetch("https://qrflow.codes/api/v1/codes", {
      method: "POST",
      headers: { Authorization: \`Bearer ${env.QRFLOW_KEY}\`, "Content-Type": "application/json" },
      body: JSON.stringify({ type: "url", destination_data: { url }, label }),
    });
    return new Response(r.body, { status: r.status, headers: { "Content-Type": "application/json" } });
  },
};
Deno.serve(async (req) => {
  const { url, label } = await req.json();
  const r = await fetch("https://qrflow.codes/api/v1/codes", {
    method: "POST",
    headers: { Authorization: \`Bearer ${Deno.env.get("QRFLOW_KEY")}\`, "Content-Type": "application/json" },
    body: JSON.stringify({ type: "url", destination_data: { url }, label }),
  });
  return new Response(await r.text(), { status: r.status, headers: { "Content-Type": "application/json" } });
});
// supabase secrets set QRFLOW_KEY=qrf_live_...
  • npm paketi qrflow\ yalnızca fetch ve WebCrypto kullanır; bu nedenle tümünde değişiklik yapmadan çalışır.

Python: FastAPI, Flask, Django, bir betik

Ne zaman: Arka ucunuz Python ise.

import os
from fastapi import FastAPI, HTTPException, Response
from qrflow import QRFlow, QRFlowError   # https://qrflow.codes/sdk/qrflow.py

app = FastAPI()
qr = QRFlow(os.environ["QRFLOW_KEY"])

@app.post("/qr")
def make_qr(url: str, label: str | None = None):
    try:
        code = qr.create_code(type="url", destination_data={"url": url}, label=label)["code"]
    except QRFlowError as e:
        raise HTTPException(e.status, {"error": e.code, "message": str(e)})
    return {"id": code["id"], "short_url": code["short_url"]}

@app.get("/qr/{code_id}.svg")
def qr_image(code_id: str):
    import urllib.request
    req = urllib.request.Request(qr.image_url(code_id), headers={"Authorization": f"Bearer {os.environ['QRFLOW_KEY']}"})
    with urllib.request.urlopen(req) as r:
        return Response(r.read(), media_type="image/svg+xml")

Sipariş, masa, ürün, bilet veya etkinlik başına bir QR kodu

Ne zaman: Tablolarınızdan birindeki her satır için otomatik olarak ayrı bir kod gerekiyorsa.

  1. Tablonuza iki sütun ekleyin: qrflow_code_id (uuid) ve qr_short_url (text).
  2. Bir satır oluşturulduğunda, satırın herkese açık URL'sini ve satırı adlandıran bir etiketi ("Order 10432", "Table 7") kullanarak POST /codes çağrısı yapın. id ve short_url değerlerini kaydedin.
  3. Satırın sayfası taşındığında (yeni alan adı, yeni yol), destination_data değerini PATCH ile güncelleyin. Basılı kodlar çalışmaya devam eder.
  4. Satır kullanımdan kaldırıldığında, herhangi bir şey basıldıysa PATCH { paused: true } çağrısı yapın; hiçbir şey basılmadıysa yalnızca DELETE kullanın.
  5. Aynı anda binlerce koda mı ihtiyacınız var (300 restoran için her masaya bir menü)? POST /codes/bulk çağrısını gruplar hâlinde kullanın ve dönen kodları etiket veya sipariş numarasına göre satırlarınızla eşleştirin.
const { code } = await qr.createCode({
  type: "url",
  destination_data: { url: \`https://example.com/orders/${order.id}\` },
  label: \`Order ${order.number}\`,
});
await db.orders.update(order.id, { qrflow_code_id: code.id, qr_short_url: code.short_url });
  • Business planında adil kullanım sınırı 25,000 kayıtlı koddur; API bu sayının iki katında durur. Her makbuz için sonsuza kadar bir kod gerekiyorsa önce bizimle görüşün: hello@qrflow.codes.

Basılı bir kodun yönlendirildiği yeri değiştirin

Ne zaman: Bir kampanya sona erdiğinde, bir sayfa taşındığında, bir PDF değiştirildiğinde veya sezon değiştiğinde.

curl -X PATCH https://qrflow.codes/api/v1/codes/$CODE_ID \
  -H "Authorization: Bearer $QRFLOW_KEY" -H "Content-Type: application/json" \
  -d '{ "destination_data": { "url": "https://example.com/spring" } }'

Duraklatın veya bitiş tarihi belirleyin

# Scans show a "paused" page instead of redirecting
curl -X PATCH https://qrflow.codes/api/v1/codes/$CODE_ID -H "Authorization: Bearer $QRFLOW_KEY" \
  -H "Content-Type: application/json" -d '{ "paused": true }'

# Stops working after the date; null clears it
curl -X PATCH https://qrflow.codes/api/v1/codes/$CODE_ID -H "Authorization: Bearer $QRFLOW_KEY" \
  -H "Content-Type: application/json" -d '{ "expires_at": "2026-12-31T23:59:59Z" }'
  • Yalnızca dinamik kodlar yeniden yönlendirilebilir; statik kodlar 400 not_dynamic yanıtı verir. Wi-Fi, vCard ve düz metin kodları içeriklerini desenlerinde taşır ve hiçbir zaman dinamik olamaz; bu nedenle POST /codes/:id/dynamic çağrısı bunlar için 400 not_dynamic_capable yanıtı verir. url, phone, email, sms ve location kodlarında Free planı ilk kodu dinamik, geri kalanları statik yapar; ücretli planlarda ise tümü dinamiktir. Hesabınızda hâlâ kullanım hakkı varsa POST /codes/:id/dynamic statik bir kodu dinamik koda dönüştürür. Görsel değişeceğinden sonrasında yeniden oluşturup yazdırın.
  • Tarayıcı, bir sonraki taramada yeni hedefi görür. Beklemeniz gereken bir önbellek yoktur.

Kodları kendi alan adınızda yazdırın

Ne zaman: Kodda qrflow.codes/q/x7k2p9a yerine go.example.com/menu görmek istiyorsanız.

  1. Account sayfasında, Your own link domain bölümüne go.example.com ekleyin ve DNS sağlayıcınızda gösterilen CNAME kaydını oluşturun. Doğrulama genellikle birkaç dakika içinde tamamlanır.
  2. Bundan sonra oluşturulan her yeni dinamik kodun short_url değeri bu alan adını kullanır. Mevcut kodlar da değişir: görsellerinde qrflow.codes/q/... kodlanmıştır ve bu adres yönlendirme yapmaya devam eder; dolayısıyla basılı hiçbir şey bozulmaz.
  3. slug ile kodlara okunabilir adlar verin: PATCH { "slug": "menu" } çağrısı go.example.com/menu oluşturur. Bunu yazdırmadan önce yapın.
  4. Birden fazla alan adına sahip Business planında GET /domains bunları kimlikleriyle listeler; kod başına seçim yapmak için POST veya PATCH çağrısında domain_id gönderin.

Bir bağlantıya ad verin ve alan adı seçin

curl https://qrflow.codes/api/v1/domains -H "Authorization: Bearer $QRFLOW_KEY"
# { "default_base": "https://go.example.com", "domains": [ { "id": "…", "host": "go.example.com", "is_default": true, … }, { "id": "…", "host": "qr.example.fr", … } ] }

curl -X PATCH https://qrflow.codes/api/v1/codes/$CODE_ID -H "Authorization: Bearer $QRFLOW_KEY" -H "Content-Type: application/json" \
  -d '{ "slug": "menu", "domain_id": "<id of qr.example.fr>" }'
# short_url is now https://qr.example.fr/menu

Kendi yönetim panelinizde tarama grafiği

Ne zaman: Kendi sayılarınızın yanında günlük, ülkeye veya cihaza göre tarama sayılarını görmek istiyorsanız.

const stats = await qr.scans(code.id, { from: "2026-09-01", to: "2026-09-30", group: "day" });
// stats.total -> 412
// stats.rows  -> [{ key: "2026-09-01", scans: 18 }, { key: "2026-09-02", scans: 25 }, ...]
// Feed rows straight into Recharts, Chart.js, or a <table>.

const byCountry = await qr.scans(code.id, { group: "country" });   // [{ key: "US", scans: 300 }, { key: "MX", scans: 41 }]
const byDevice  = await qr.scans(code.id, { group: "device" });    // mobile, desktop, tablet
  • Tek bir istek en fazla 92 günü kapsar; daha uzun aralıklar için döngü kullanın. Tarihler UTC'dir.
  • Yoklama yapmadan canlı sayılar almak için tarama etkinliğine bir webhook abone edin: birkaç dakikada bir, ayrıntılarıyla birlikte tüm taramaları gruplar hâlinde alırsınız.

Next.js'te webhook alın ve doğrulayın

Ne zaman: Bir kod tarandığında veya değiştirildiğinde bunu kendi veritabanınızda neredeyse gerçek zamanlı olarak öğrenmek istiyorsanız.

  1. Webhook'u Account › Webhooks sayfasında veya POST /webhooks ile oluşturun. Gizli anahtarı (whsec_...) yalnızca bir kez QRFLOW_WEBHOOK_SECRET içine kopyalayın.
  2. Ayrıştırmadan önce ham gövdeyi metin olarak okuyun; imza tam bayt dizisini kapsar.
  3. Doğrulayın, ardından etkinliğe göre işlem yapın. 2xx yanıtını hızlıca verin; yavaş işlemleri yanıt verdikten sonra veya bir kuyrukta gerçekleştirin.
  4. İmzalı bir ping almak ve bağlantının doğru çalıştığını doğrulamak için webhook'ta Test düğmesine basın.
import { createHmac, timingSafeEqual } from "node:crypto";

function verify(raw: string, header: string, secret: string): boolean {
  const t = /t=(\d+)/.exec(header)?.[1], v1 = /v1=([a-f0-9]+)/.exec(header)?.[1];
  if (!t || !v1 || Math.abs(Date.now() / 1000 - Number(t)) > 300) return false;
  const expected = createHmac("sha256", secret).update(\`${t}.${raw}\`).digest("hex");
  return expected.length === v1.length && timingSafeEqual(Buffer.from(expected), Buffer.from(v1));
}

export async function POST(req: Request) {
  const raw = await req.text();
  if (!verify(raw, req.headers.get("x-qrflow-signature") ?? "", process.env.QRFLOW_WEBHOOK_SECRET!)) {
    return new Response("bad signature", { status: 401 });
  }
  const evt = JSON.parse(raw) as { id: string; event: string; created_at: string; data: any };
  // evt.id is stable across retries: store it and skip duplicates.

  switch (evt.event) {
    case "scan":          // evt.data.scans[]: code_id, label, slug, scanned_at, device, country, city, referrer, browser, os, language
      break;
    case "code.created":  // evt.data.code, evt.data.source
    case "code.updated":  // evt.data.code, evt.data.changed[]
    case "code.deleted":  // evt.data.code { id, label, short_code, slug }
      break;
    case "ping":          // the Test button
      break;
  }
  return new Response(null, { status: 204 });
}
  • Yerel ortamda, geliştirme sunucunuzu bir tünelle dışarı açın (cloudflared tunnel --url http://localhost:3000, veya ngrok) ve geliştirme sırasında webhook için bu https URL'sini kullanın.
  • npm paketi bunu sizin için yapar: import { parseWebhook } from "qrflow"\ tek çağrıda doğrulama ve ayrıştırma yapar (WebCrypto kullandığından Workers ve Deno'da da çalışır). Python istemcisi verify_webhook işlevini içerir.

Python'da webhook alın

Ne zaman: Aynı etkinlikleri alan Flask, FastAPI veya Django uygulaması.

import os, json
from flask import Flask, request, abort
from qrflow import verify_webhook   # https://qrflow.codes/sdk/qrflow.py

app = Flask(__name__)

@app.post("/qrflow")
def hook():
    raw = request.get_data()  # bytes, before any parsing
    if not verify_webhook(raw, request.headers.get("X-QRFLOW-Signature", ""), os.environ["QRFLOW_WEBHOOK_SECRET"]):
        abort(401)
    evt = json.loads(raw)
    if evt["event"] == "scan":
        for s in evt["data"]["scans"]:
            print(s["code_id"], s["scanned_at"], s["country"], s["device"])
    return "", 204

CSV dosyasından binlerce kod

Ne zaman: Her SKU, koltuk, varlık etiketi veya posta gönderisi için bir kod gerekiyorsa.

import { parse } from "csv-parse/sync";
import { readFileSync } from "node:fs";

const rows = parse(readFileSync("skus.csv"), { columns: true }) as Array<{ sku: string; url: string }>;
const out: Array<{ sku: string; id: string; short_url: string }> = [];

for (let i = 0; i < rows.length; i += 2000) {                 // Business: 2,000 per request
  const chunk = rows.slice(i, i + 2000);
  const { codes, rejected, remaining_this_month } = await qr.bulkCreate(
    chunk.map((r) => ({ destination: r.url, label: r.sku })),
  );
  codes.forEach((c, j) => out.push({ sku: chunk[j].sku, id: c.id, short_url: c.short_url }));
  if (rejected.length) console.warn(rejected);                  // rows that were not web addresses
  console.log(remaining_this_month, "left this month");
}
  • Toplu işlem yalnızca dinamik url kodları oluşturur ve tümü aynı renkleri kullanır. Kodlar, reddedilen satırlar çıkarıldıktan sonra gönderdiğiniz sırayla döner; emin olmadığınızda label ile eşleştirin.
  • Webhook'lar, her kod için ayrı bir code.created etkinliği yerine codes[] içeren tek bir code.created etkinliğini her toplu istek için gönderir.

Kullanıcılarınızın kendi QRFLOW hesaplarını bağlamasına izin verin (OAuth)

Ne zaman: Başkaları için bir ürün geliştiriyor ve kodların sizin hesabınıza değil, onların QRFLOW hesaplarına eklenmesini istiyorsanız.

  1. Bir kez istemci kaydedin: client_name ve redirect_uris ile POST https://qrflow.codes/api/oauth/register çağrısı yapın. Bir client_id (ve gizli istemciler için bir client_secret) alırsınız.
  2. Kullanıcıyı response_type=code, client_id, redirect_uri, scope, state ve PKCE (code_challenge, code_challenge_method=S256) parametreleriyle /oauth/authorize adresine yönlendirin.
  3. Kodu /api/oauth/token adresinde değiştirin. Refresh token'ı saklayın; access token'lar bir saat geçerlidir.
  4. Authorization: Bearer <access_token> ile /api/v1 çağrısı yapın. Her şey bir anahtarla olduğu gibi, kullanıcının planı kapsamında çalışır.
curl -X POST https://qrflow.codes/api/oauth/register -H "Content-Type: application/json" \
  -d '{ "client_name": "Acme Menus", "redirect_uris": ["https://app.example.com/oauth/qrflow"], "token_endpoint_auth_method": "none" }'
# { "client_id": "dyn_…", "redirect_uris": [...], "grant_types": ["authorization_code","refresh_token"], … }
https://qrflow.codes/oauth/authorize?response_type=code&client_id=dyn_…&redirect_uri=https%3A%2F%2Fapp.example.com%2Foauth%2Fqrflow
  &scope=profile%20codes%3Aread%20codes%3Awrite%20analytics%3Aread&state=…&code_challenge=…&code_challenge_method=S256
  • Kapsamlar API anahtarlarıyla aynı altı kapsamdır. Yalnızca ihtiyacınız olan en az kapsamı isteyin; izin ekranında kapsamlar listelenir.
  • Uygulamanız bir sohbet asistanı veya ajansa, authorize isteğine resource=https://qrflow.codes/mcp ekleyin ve bunun yerine MCP sunucusuyla iletişim kurun; token bu sunucuya bağlanır.

Zapier, Make, n8n: hiç kod yazmadan

Ne zaman: Taramaların veya yeni kodların bir tabloya, Slack kanalına ya da CRM'e ulaşmasını istiyorsanız.

  1. Bir catch-hook tetikleyicisi oluşturun (Zapier: Webhooks by Zapier › Catch Hook; Make: Custom webhook; n8n: Webhook node) ve https URL'sini kopyalayın.
  2. Account › Webhooks sayfasında bu URL'yi ekleyip etkinlikleri seçin. Test düğmesine basın; ping araçta görünür ve yükün yapısını gösterir.
  3. data.scans[] (tarama için) veya data.code (code.* için) verilerini tablonuza, iletinize ya da kaydınıza eşleyin.
  4. Bu araçlardan kod oluşturmak için Authorization başlığıyla POST /codes adresine HTTP modülünü kullanın. Anahtarı aracın kimlik bilgileri deposunda saklayın.
  • Zapier'de artık bir QRFLOW.codes uygulaması var: Create QR Code, Update QR Code ve Find adımları ile anlık New Scan tetikleyicisi webhook kurulumu veya API anahtarı gerektirmez. Bkz. Zapier ile QRFLOW. Aşağıdaki adımlar Make, n8n ve diğer araçlar içindir.
  • Bu araçlar imzayı doğrulayamaz. Size verilen URL tahmin edilemez; sahip olduğunuz koruma budur. URL'yi hiçbir yerde paylaşmayın.
  • Listeniz zaten Google Sheets'te bulunuyorsa webhook'a hiç ihtiyacınız olmayabilir: QRFLOW for Google Sheets eklentisi Premium planında, API anahtarı olmadan her satır için bir kod oluşturur ve kısa bağlantıyı ve tarama sayısını tabloya geri yazar. Bkz. Google Sheets eklentisi.

Vibe coding

Yapıştırılacak istemler

Kodlama asistanlarına kurallar baştan söylendiğinde doğru çözümü oluştururlar. Bu istemler kuralları içerir. Birini yapıştırın, köşeli parantez içindeki alanı doldurun; asistan kod yazmaya başlamadan önce Markdown başvuru belgesini okuyacaktır.

Uygulamama QR kodları ekle

Claude, ChatGPT, Cursor, Codex, Windsurf, Copilot Chat: sohbete yapıştırın

Add QR codes to this project using the QRFLOW.codes API.

Read https://qrflow.codes/llms-full.txt before writing code; it is the complete reference.

Rules:
- The API key is in the environment variable QRFLOW_KEY. It must only be used server-side (route handler, server action, edge function). Never expose it to the browser.
- Create dynamic codes: POST https://qrflow.codes/api/v1/codes with { "type": "url", "destination_data": { "url": ... }, "label": ... }.
- Save the returned code.id and code.short_url on my record. short_url is what gets printed or displayed.
- Show the image by proxying GET /codes/:id/image.svg through my server, or by encoding short_url with a QR library on the client.
- Handle errors from the JSON body: { "error", "message" }. Map 402 to "upgrade needed", 429 to a retry with the Retry-After header.

What I want: [describe the feature, e.g. "every event in my events table gets a QR code that opens its public page; show it on the event admin page with a download button"].

Depoya QRFLOW'u öğretin

CLAUDE.md, AGENTS.md,.cursorrules veya.github/copilot-instructions.md dosyasına ekleyin

## QR codes (QRFLOW.codes)
- Docs: https://qrflow.codes/llms-full.txt (Markdown), https://qrflow.codes/api/v1/openapi.json (OpenAPI 3.1).
- Base URL https://qrflow.codes/api/v1, header Authorization: Bearer $QRFLOW_KEY. Server-side only.
- Codes are created with POST /codes { type: "url", destination_data: { url }, label }. Store code.id and code.short_url.
- Change the destination with PATCH /codes/:id { destination_data: { url } }. Never change slug/domain_id after printing.
- Image: GET /codes/:id/image.svg (needs the key). Prefer paused: true over DELETE when a print exists.
- Webhooks arrive as POST with X-QRFLOW-Signature (t=,v1=HMAC-SHA256 of "t.rawBody"); verify with the raw body.

Lovable, Bolt, v0, Replit ve diğer uygulama oluşturucularda

Arka uç sağlayan, önceliği ön yüz olan oluşturucular (Supabase, serverless functions)

Integrate QRFLOW.codes QR codes. The API refuses browser calls, so create a backend function (Supabase Edge Function / serverless function) that holds the secret QRFLOW_KEY and calls POST https://qrflow.codes/api/v1/codes with { "type": "url", "destination_data": { "url": "<the page URL>" }, "label": "<name>" }. Return code.id and code.short_url to the UI and save them in the database. Render the QR in the UI by encoding short_url with a QR library; add a "Download for print" button that fetches /codes/:id/image.svg through the same backend function. Reference: https://qrflow.codes/llms-full.txt

Kodlarımı yöneten özel bir GPT

ChatGPT › Create a GPT › Actions

Import from URL: https://qrflow.codes/api/v1/openapi.json
Authentication: API Key › Bearer › paste a Business key with the scopes you want the GPT to have.
Then the GPT can list, create, re-point and report on your codes. For a no-setup version, add the MCP connector instead (Developer mode › Plugins › https://qrflow.codes/mcp).

Bağlayıcı etkinleştirildikten sonra söylenecekler

QRFLOW MCP sunucusuna bağlı Claude, ChatGPT, Claude Code

"Make a QR code for https://example.com/fall-menu, call it Fall menu, frame caption 'Scan for menu'."
"Which of my codes got the most scans this month? Show a breakdown by country for the top one."
"Point the 'Lobby poster' code at https://example.com/events/october."
"Name the 'Business card' code's link 'hi' on my domain."
"Pause every code with 'Summer' in the label."
"Make 40 codes, one per table, going to https://example.com/order?table=1 through 40."
"Show me the PNG of the 'Front door' code."

MCP sunucusu

Claude, ChatGPT, Cursor ve Claude Code'dan kullanın

QRFLOW, https://qrflow.codes/mcp adresinde bir MCP sunucusudur. Bir kez bağlanıp oturum açın; ardından "sonbahar menümüzün sayfası için alan adımda menu adlı bir QR kodu oluştur", "lobi posterindeki kodu yeni sayfaya yönlendir" veya "broşür geçen hafta ülkelere göre kaç kez tarandı?" gibi isteklerde bulunun. Asistan, bu API'nin sunduğu araçların aynısını aynı kurallar kapsamında kullanır ve kodlar, kaynak olarak mcp ile kontrol panelinizde görünür.

Geliştirici değil misiniz? Her asistan için tam tıklama adımlarını içeren sade anlatım Yapay zekâ asistanınızla QR kodları oluşturun sayfasındadır.

Glama tarafından bağımsız olarak puanlanır ve saat başı sağlık kontrolünden geçirilir; awesome-remote-mcp-servers dizininde ve resmî MCP Registry'de codes.qrflow/qrflow olarak listelenir.

Bağlanın

Customize › Connectors › Add custom connector › adresi yapıştırın veya QRFLOW'un dizin kaydındaki Connect düğmesine basın. Claude, QRFLOW oturum açma sayfasını açar; Allow düğmesine basın. Tüm planlarda çalışır.

https://qrflow.codes/mcp

Settings › Security and login › Developer mode'u açın, ardından Settings › Plugins › + › adresi yapıştırın; istendiğinde oturum açın. Plus, Pro, Team, Enterprise ve Edu planlarında kullanılabilir.

https://qrflow.codes/mcp

Tek bir komut, ardından oturum açmak için /mcp. Oturum açmayı atlamak için Business anahtarını başlık olarak ekleyin.

claude mcp add --transport http qrflow https://qrflow.codes/mcp
# or, with a key:
claude mcp add --transport http qrflow https://qrflow.codes/mcp --header "Authorization: Bearer $QRFLOW_KEY"

Cursor, Windsurf, VS Code ve tüm MCP istemcileri

URL'de bir HTTP sunucusu ekleyin. OAuth ile oturum açma tarayıcıda gerçekleşir; alternatif olarak anahtarla bir Authorization başlığı gönderin.

{
  "mcpServers": {
    "qrflow": { "type": "http", "url": "https://qrflow.codes/mcp" }
  }
}

Kendi ajansınız (Anthropic veya OpenAI SDK)

MCP bağlayıcısını veya aracını URL'ye yönlendirin ve bearer olarak bir Business anahtarı kullanın; tarayıcı akışı gerekmez.

// Anthropic Messages API, MCP connector
mcp_servers: [{ type: "url", url: "https://qrflow.codes/mcp", name: "qrflow", authorization_token: process.env.QRFLOW_KEY }]

Asistan neler yapabilir?

AraçNe yapar?Kapsam
list_code_kindsHer kod türünü, alanlarını ve gerektirdiği planı listeler. Asistan, alışılmadık bir şey oluşturmadan önce bunu çağırır.profile
list_domainsBağlantı alan adlarınızı, varsayılanı ve kimliklerini listeler.domains:read
get_qr_imageAsistanın gösterebileceği veya kaydedebileceği bir PNG ve baskı için SVG URL'si sağlar.codes:read
get_accountHesabın planını, özelliklerini ve sınırlarını gösterir.profile

Güvenliği nasıl sağlanıyor?

  • Asistan yalnızca sizin hesabınız için, siz bir QRFLOW sayfasında Allow düğmesine bastıktan sonra verilen bir token'ı tutar. Account › Connected apps sayfasından istediğiniz zaman bağlantıyı kesin.
  • Token'lar MCP sunucusuna bağlıdır; REST API'ye karşı yeniden kullanılamaz.
  • Her yazma işlemi kontrol panelindeki doğrulama kurallarından geçer: izin verilen hedefler, plan kontrolleri ve adil kullanım sınırları.
  • Yıkıcı araçların açıklamaları dikkatle hazırlanmıştır: delete_qr_code, basılı bir kod varsa modelin kodu duraklatmayı tercih etmesini söyler.
  • Keşif belgeleri /.well-known/oauth-authorization-server ve /.well-known/oauth-protected-resource adreslerinde bulunur; kayıt RFC 7591'e, PKCE ise yalnızca S256'ya uygundur.

SDK'lar ve OpenAPI belirtimi

  • TypeScript / JavaScript: npm install qrflow (npm). Sıfır bağımlılık, ESM ve CommonJS, tam tür desteği; Node 18+, Bun, Deno ve Workers üzerinde çalışır. 429 yanıtlarını sizin için yeniden dener ve verifyWebhook / parseWebhook sunar.
  • Python 3.9+, yalnızca standart kitaplık: qrflow.py.
  • OpenAPI 3.1: /api/v1/openapi.json. Postman veya Insomnia'ya aktarın, herhangi bir dilde istemci oluşturun ya da bir ChatGPT Action'a ekleyin.
  • Her iki istemci de türlendirilmiş bir hata (QRFlowError, status, code, message, retryAfter ile) fırlatır ve bir webhook doğrulayıcı sunar. Tek dosyalık TypeScript kaynak kodu hâlâ /sdk/qrflow.ts konumunda; isterseniz doğrudan projenize alabilirsiniz.
TypeScriptPythonÇağrılar
me()me()GET /me
catalog()catalog()GET /catalog
listCodes({ limit, q })list_codes(limit, q)GET /codes
getCode(id)get_code(id)GET /codes/:id
createCode(input)create_code(**fields)POST /codes
updateCode(id, patch)update_code(id, **patch)PATCH /codes/:id
deleteCode(id)delete_code(id)DELETE /codes/:id
makeDynamic(id)make_dynamic(id)POST /codes/:id/dynamic
scans(id, { from, to, group })scans(id, from_, to, group)GET /codes/:id/scans
bulkCreate(rows, colors)bulk_create(rows, **colors)POST /codes/bulk
domains()domains()GET /domains
listWebhooks() / createWebhook() / testWebhook(id) / deleteWebhook(id)list_webhooks() / create_webhook() / test_webhook(id) / delete_webhook(id)/webhooks
imageUrl(id, size)image_url(id, size)Görsel adresi (anahtarla alın)
verifyWebhook(raw, header, secret)verify_webhook(raw, header, secret)Teslimatlar için imza denetimi

Uç nokta başvurusu

Temel URL https://qrflow.codes/api/v1. Gövdeler ve yanıtlar JSON biçimindedir. Tarihler UTC cinsinden ISO 8601 biçimindedir. PATCH isteğinde yalnızca değişen alanları gönderin.

GETprofil

Bu hesap için geçerli plan, özellik bayrakları ve sınırların yanı sıra anahtarın kapsamları.

curl https://qrflow.codes/api/v1/me \
  -H "Authorization: Bearer $QRFLOW_KEY"
{ "id": "…", "email": "ops@example.com", "plan": "business", "paid": true,
  "features": { "dynamic_codes": true, "custom_domain": true, "link_names": true, "gs1": true, "api_keys": true },
  "limits": { "saved_codes": 25000, "bulk_per_month": 10000, "bulk_per_request": 2000, "link_domains": 5, "requests_per_minute": 600 },
  "auth": "api_key", "scopes": ["codes:read", "codes:write"] }

GETgenel

Yerel türler (url, wifi, vcard, email, phone, sms, text, location) ve yaklaşık 50 alt tür (Instagram, Google yorumu, Wi-Fi, uygulama mağazası…), her birinin gerektirdiği alanlar ve plan bilgisi. Anahtar gerekmez.

curl https://qrflow.codes/api/v1/catalog

GETcodes:read

En yeniden başlayarak listeler.?limit= en fazla 100 olabilir;?q= etiketlerde arama yapar.

curl "https://qrflow.codes/api/v1/codes?limit=20&q=menu" \
  -H "Authorization: Bearer $QRFLOW_KEY"

POSTcodes:write

Kurallar, sitedeki Kaydet ile aynıdır: url, phone, email, sms ve location kodları ücretli planlarda dinamiktir; Wi-Fi, vCard ve text içeriklerini desende taşır. Örneğin bir Google yorumu kodu oluşturmak için destination_data.subtype içine bir alt tür kimliği koyun. İsteğe bağlı domain_id, kodun hangi bağlantı alan adınızla oluşturulacağını seçer (alan adlarını GET /domains listeler).

curl -X POST https://qrflow.codes/api/v1/codes \
  -H "Authorization: Bearer $QRFLOW_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "type": "url", "destination_data": { "url": "https://example.com/menu" }, "label": "Table tents", "frame_style": "caption-below", "frame_caption": "Scan for menu" }'
{ "code": { "id": "…", "label": "Table tents", "kind": "url", "dynamic": true, "short_code": "x7k2p9a",
  "short_url": "https://go.example.com/x7k2p9a", "scans": 0, "image_url": "https://qrflow.codes/api/v1/codes/…/image.svg", … } }

GETcodes:read

Tarama sayısı, kısa bağlantı ve görsel adresiyle birlikte kod.

curl https://qrflow.codes/api/v1/codes/$ID \
  -H "Authorization: Bearer $QRFLOW_KEY"

PATCHcodes:write

Şunlardan herhangi biri: destination_data (yalnızca dinamik kodlarda; baskı geçerliliğini korur), label, paused, expires_at (ISO veya null), slug (alan adınızdaki bağlantı adı), domain_id (kodun hangi bağlantı alan adınızla oluşturulacağı; null = hesabın varsayılanı), fg_color, bg_color, frame_style, frame_caption, frame_caption2. Yalnızca değiştirdiğiniz alanları gönderin.

curl -X PATCH https://qrflow.codes/api/v1/codes/$ID \
  -H "Authorization: Bearer $QRFLOW_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "destination_data": { "url": "https://example.com/menu-fall" }, "slug": "menu" }'

DELETEcodes:write

Tarama geçmişi de dâhil olmak üzere kalıcı olarak silinir. Dinamik kodun basılı bağlantısı artık çalışmaz. Baskı hâlâ dolaşımdaysa paused: true kullanmayı tercih edin.

curl -X DELETE https://qrflow.codes/api/v1/codes/$ID \
  -H "Authorization: Bearer $QRFLOW_KEY"
204 No Content

POSTcodes:write

Basılı desen değişir (artık kısa bağlantıyı kodlar); bu nedenle sonrasında görseli yeniden oluşturun.

curl -X POST https://qrflow.codes/api/v1/codes/$ID/dynamic \
  -H "Authorization: Bearer $QRFLOW_KEY"

GETcodes:read

Çerçevesi ve renkleriyle baskıya hazır SVG.?size= modül ızgarasının genişliğini piksel cinsinden ayarlar; dosya her durumda kalite kaybı olmadan ölçeklenir.

curl https://qrflow.codes/api/v1/codes/$ID/image.svg \
  -H "Authorization: Bearer $QRFLOW_KEY" -o code.svg

GETanalytics:read

?from= ve?to= (ISO tarihleri, en fazla 92 gün; varsayılan son 30 gün) ve?group= day, device, country, city, browser, os veya referrer. Analiz sayfasındaki sayılarla aynıdır.

curl "https://qrflow.codes/api/v1/codes/$ID/scans?from=2026-09-01&to=2026-09-21&group=day" \
  -H "Authorization: Bearer $QRFLOW_KEY"
{ "code_id": "…", "from": "…", "to": "…", "group": "day", "total": 412,
  "rows": [ { "key": "2026-09-01", "scans": 18 }, { "key": "2026-09-02", "scans": 25 }, … ] }

POSTcodes:write

Tek çağrıda en fazla 2.000 URL kodu; tümü dinamiktir. Bulk sayfasıyla aynı aylık toplu işlem kotasından düşer (Business planında 10.000). Web adresi olmayan satırlar rejected içinde döner; diğerleri oluşturulur.

curl -X POST https://qrflow.codes/api/v1/codes/bulk \
  -H "Authorization: Bearer $QRFLOW_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "rows": [ { "destination": "https://example.com/t/1", "label": "Table 1" }, { "destination": "https://example.com/t/2", "label": "Table 2" } ] }'
{ "codes": [ … ], "rejected": [], "remaining_this_month": 9998 }

GETcodes:read

Perakende ambalajlarına konan kodlar. Her ürün bir GTIN, ambalajda basılan adres ve arkasındaki bağlantılardan oluşur.?q= ile adlarda ve GTIN'lerde arama yapın. Business planı gerekir.

curl https://qrflow.codes/api/v1/products \
  -H "Authorization: Bearer $QRFLOW_KEY"
{ "products": [ { "gtin": "00860001234565", "name": "Wildflower Honey 12 oz",
    "digital_link": "https://id.example.com/01/00860001234565",
    "page_url": "https://id.example.com/p/00860001234565",
    "links": [ { "link_type": "gs1:pip", "url": "…", "is_default": true, "batch": null } ] } ] }

POSTcodes:write

gtin ve name zorunludur; brand ve url isteğe bağlıdır. Herhangi bir veri yazılmadan önce kontrol basamağı doğrulanır ve 8, 12, 13 ve 14 basamaklı biçimlerin tümü 14 basamağa normalleştirilir. Zaten sahip olduğunuz bir GTIN için ikinci bir ürün oluşturulmaz; 409 döner.

curl -X POST https://qrflow.codes/api/v1/products \
  -H "Authorization: Bearer $QRFLOW_KEY" -H "Content-Type: application/json" \
  -d '{"gtin":"00860001234565","name":"Wildflower Honey 12 oz","brand":"Sunny Acres","url":"https://sunnyacres.example/honey"}'
{ "product": { "gtin": "00860001234565", "digital_link": "https://id.example.com/01/00860001234565", … } }

PUTcodes:write

Tek bir GTIN aynı anda birden fazla yere yönlendirebilir; her bağlantı ne işe yaradığını belirten bir etiket taşır. Varsayılan olarak telefon kullanılır; tür isteyen bir uygulama ise o türe ait bağlantıyı alır. İdempotenttir: aynı link_type ve batch, ikinci bir bağlantı eklemek yerine mevcut bağlantıyı değiştirir; böylece gece çalışan bir betik iki kez çalıştırılabilir. Bağlantıyı tek bir partiyle sınırlamak için batch gönderin; böylece üretimin geri kalanına dokunmadan geri çağırma yayımlayabilirsiniz.

curl -X PUT https://qrflow.codes/api/v1/products/00860001234565/links \
  -H "Authorization: Bearer $QRFLOW_KEY" -H "Content-Type: application/json" \
  -d '{"link_type":"gs1:recallStatus","url":"https://sunnyacres.example/recall-a42","title":"Recall notice","batch":"A42","is_default":true}'

GETanalytics:read

Son?days= (1 ila 365, varsayılan 30) gün için GTIN başına sayılır; ülke, cihaz, bağlantı türü ve partiye göre ayrılır. went_nowhere, hedef bulamayan taramaları sayar ve sıfır olmalıdır.

curl "https://qrflow.codes/api/v1/products/00860001234565/scans?days=30" \
  -H "Authorization: Bearer $QRFLOW_KEY"
{ "gtin": "00860001234565", "days": 30, "total": 412, "went_nowhere": 0,
  "by_link_type": [ { "key": "gs1:pip", "scans": 390 }, { "key": "gs1:recallStatus", "scans": 22 } ],
  "by_batch": [ { "key": "A42", "scans": 22 } ] }

GETdomains:read

Bağlı alan adlarınız, durumları ve dinamik kodların varsayılan olarak hangisiyle oluşturulduğu (default_base). Bir kodu farklı bir alan adıyla oluşturmak için alan adının kimliğini domain_id olarak gönderin.

curl https://qrflow.codes/api/v1/domains \
  -H "Authorization: Bearer $QRFLOW_KEY"

GETwebhooks:manage

Webhook'larınız; olayları, son durumları ve hata sayılarıyla birlikte.

curl https://qrflow.codes/api/v1/webhooks \
  -H "Authorization: Bearer $QRFLOW_KEY"

POSTwebhooks:manage

url, herkese açık bir sunucuda https olmalıdır; events, scan, code.created, code.updated, code.deleted değerlerinden herhangi biri olabilir. İmzalama sırrı yalnızca bir kez döndürülür.

curl -X POST https://qrflow.codes/api/v1/webhooks \
  -H "Authorization: Bearer $QRFLOW_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://example.com/hooks/qrflow", "events": ["scan", "code.updated"] }'
{ "webhook": { "id": "…", "url": "…", "events": ["scan", "code.updated"], "active": true, "secret": "whsec_…" } }

POSTwebhooks:manage

Şimdi imzalı bir ping gönderir ve yanıtı bildirir.

curl -X POST https://qrflow.codes/api/v1/webhooks/$WEBHOOK_ID \
  -H "Authorization: Bearer $QRFLOW_KEY"

DELETEwebhooks:manage

Kuyruğa alınmış yeniden denemeler dâhil tüm teslimatları durdurur.

curl -X DELETE https://qrflow.codes/api/v1/webhooks/$WEBHOOK_ID \
  -H "Authorization: Bearer $QRFLOW_KEY"
204 No Content

GETgenel

Özelleştiricideki gibi gruplandırılmış çerçeve kimlikleri ve her birinin gerektirdikleri (başlık, ikinci satır). Anahtar gerekmez.

curl https://qrflow.codes/api/v1/frames

Code nesnesi

Bir kodla ilgili her uç nokta aynı yapıyı döndürür. Bilmediğiniz alanları yok sayın; zaman içinde yenileri eklenir.

AlanTürAnlamı
iduuidSabit kimlik. Diğer tüm çağrılarda bunu kullanın.
labelstring | nullKontrol panelindeki ad. En fazla 120 karakter. ?q= ile aranabilir.
kindstringKatalog kimliği: url, wifi, instagram, googlereview,... kind_label, kullanıcıya gösterilen addır.
typestringKodlama: url, text, wifi, vcard, email, phone, sms, location.
destination_dataobjectGönderdiğiniz alanlar (artı türler için subtype). destination, bunların tek satırlık özetidir.
dynamicbooleanTaramalar QRFLOW üzerinden geçiyorsa ve hedef değiştirilebiliyorsa true olur. dynamic_capable, bu türün ücretli bir planda dinamik olup olamayacağını belirtir.
short_codestringYedi karakter; asla değişmez.
short_urlstringDinamik kod için basılacak adres. Ayarlanmışsa alan adınızı ve slug değerini içerir.
domain_iduuid | nullKodun hangi bağlantı alan adıyla oluşturulduğu; null, hesabın varsayılanı anlamına gelir.
fg_color, bg_colorhexModül ve arka plan renkleri.
has_logobooleanKontrol panelinde logo eklenmiştir; image.svg bu logoyu içerir.
frame_style, frame_caption, frame_caption2string | nullÖzelleştiricideki gibi çerçeve kimliği ve başlıklar.
scansintegerToplam tarama sayısı.
created_at, updated_atISO 8601UTC.
manage_urlurlKontrol panelindeki kod sayfası; 'QRFLOW'da aç' bağlantısı için kullanılır.
image_urlurlGET /codes/:id/image.svg. Authorization başlığı gerekir; herkese açık bir görsel URL'si değildir.
svg_download_url, png_download_urlurlAynı SVG (çerçeve, renkler, logo) ve düz PNG; başlık gerektirmeyen, 24 saat geçerli imzalı bağlantılar üzerinden sunulur: <img> etiketler, betikler ve dosya kaydeden asistanlar için. download_expires_at, bağlantıların ne zaman geçersiz olacağını belirtir; kodun her okunması yeni bağlantılar döndürür.

Diğer yapılar: Scans (code_id, from, to, group, total, rows[key, scans]), Domain (id, host, status, active, is_default, verified_at, grace_until), Webhook (id, url, events, active, last_status, last_delivery_at, consecutive_failures, artı bir kez secret), Me (id, email, plan, paid, features, limits, auth, scopes) ve Error (error, message). OpenAPI belgesinde her özellik türlendirilmiştir.

Business

Webhook'lar

Bir olay gerçekleştiğinde QRFLOW, https URL'nizi çağırır. Account › Webhooks üzerinden veya POST /webhooks ile bir webhook oluşturun; imzalama sırrı yalnızca bir kez verilir. Hesap başına en fazla 10 webhook oluşturabilirsiniz.

OlayNe zamandata
scanToplu olarak: birkaç dakikada bir, son teslimattan bu yana gerçekleşen tüm yeni taramalar, çağrı başına en fazla 500 tarama.count, from, to, code_id, label, short_code, slug, scanned_at, device, country, city, referrer, browser, os, language alanlarını içeren scans[]
code.createdAPI ve asistanlardan anında; kontrol panelinden birkaç dakika içinde. Toplu istek, bulk: true ve codes[] içeren tek bir olay gönderir.code, source
code.updatedAynı zamanlama. Hedef, etiket, duraklatma, sona erme, bağlantı adı, alan adı, renkler, çerçeve ve dinamik koda dönüştürme değişikliklerini kapsar.code, changed[] (değişen alan adları)
code.deletedAynı zamanlama.code: { id, label, short_code, slug }
pingTest'e bastığınızda.webhook_id, message

Gelen veriler

Her yük { id, event, created_at, data } biçimindedir. id, tek bir teslimatın yeniden denemelerinde sabit kalır; böylece yinelenenleri bu değerle ayıklayabilirsiniz.

{
  "id": "9b1c6d2e-…",
  "event": "scan",
  "created_at": "2026-09-21T18:05:00.000Z",
  "data": {
    "count": 2,
    "from": "2026-09-21T18:00:00.000Z",
    "to": "2026-09-21T18:04:12.331Z",
    "scans": [
      { "code_id": "…", "label": "Table tents", "short_code": "x7k2p9a", "slug": "menu", "scanned_at": "2026-09-21T18:03:40.101Z",
        "device": "mobile", "country": "US", "city": "Las Vegas", "referrer": null, "browser": "Safari", "os": "iOS", "language": "en-US" },
      { "code_id": "…", "label": "Table tents", "short_code": "x7k2p9a", "slug": "menu", "scanned_at": "2026-09-21T18:04:12.331Z",
        "device": "mobile", "country": "MX", "city": "Tijuana", "referrer": null, "browser": "Chrome", "os": "Android", "language": "es-MX" }
    ]
  }
}
{
  "id": "2f0a…",
  "event": "code.updated",
  "created_at": "2026-09-21T18:06:00.000Z",
  "data": {
    "code": { "id": "…", "label": "Table tents", "kind": "url", "dynamic": true, "short_url": "https://go.example.com/menu", "scans": 412, "…": "…" },
    "changed": ["destination_data"]
  }
}
POST /your/endpoint HTTP/1.1
Content-Type: application/json
User-Agent: QRFLOW-Webhooks/1.0 (+https://qrflow.codes/developers)
X-QRFLOW-Event: scan
X-QRFLOW-Signature: t=1758477900,v1=5f1c…e9

İmzayı doğrulama

X-QRFLOW-Signature: t=<unix seconds>,v1=<hex>. Sırrınızla ${t}.${rawBody} üzerinde HMAC-SHA256 hesaplayın ve sonucu sabit zamanda v1 ile karşılaştırın; t beş dakikadan eskiyse isteği reddedin. Yeniden serileştirilmiş bir nesneyi değil, aldığınız ham baytları kullanın. Next.js ve Python için çalışan alıcı örnekleri tariflerde bulunur; her iki SDK da yardımcı işlevi içerir.

Teslimat kuralları

  • 8 saniye içinde herhangi bir 2xx yanıtı verin. İşlemi yanıt verdikten sonra yapın.
  • Diğer tüm yanıtlar 1, 5, 15, 60, 240 ve 720 dakika sonra yeniden denenir.
  • Arka arkaya yirmi başarısızlık webhook'u kapatır ve hesap sahibine e-posta gönderir. Alıcı düzeltildikten sonra webhook'u yeniden açın; kuyruğa alınmış yeniden denemeler devam eder.
  • URL'ler herkese açık bir sunucuda https olmalıdır. localhost, özel aralıklar ve qrflow.codes reddedilir. Geliştirme sırasında tünel kullanın.
  • İmzalı bir ping almak ve sunucunuzun verdiği yanıtın durumunu görmek için Test'e basın.

Hatalar

Her hata, aşağıdaki durum koduyla birlikte { "error": "<code>", "message": "<what to do>" } biçimindedir. Mesaj kullanıcıya yöneliktir; gösterin.

DurumerrorAnlamı

Belirti, neden, çözüm

Sorun giderme

Her çağrıda 401 invalid_token

NedenBaşlık yanlış veya anahtar etkin değil.

ÇözümTam olarak Authorization: Bearer qrf_live_… gönderin (iki nokta değil, boşluk kullanın). Anahtarın Account › API keys bölümünde iptal edilmediğini kontrol edin. Anahtarı bir sohbetten veya belgeden kopyaladıysanız sonda nokta ya da akıllı tırnak olmadığından emin olun.

MCP sunucusunda çalışan bir token ile /api/v1 üzerinde 401

Nedenhttps://qrflow.codes/mcp için oluşturulan token'lar bu sunucuya bağlıdır.

ÇözümREST için bir API anahtarı kullanın veya REST API için token almak üzere resource= olmadan ikinci bir OAuth akışı başlatın.

Anahtar veya webhook oluştururken 402 upgrade_required

NedenHer ikisi de Business özellikleridir.

Çözüm/pricing üzerinden planınızı yükseltin veya oturum açma yoluyla her planda çalışan MCP sunucusunu kullanın.

Bir OAuth uygulamasından POST /codes çağrısında 402

NedenKullanıcının planı, uygulamanın istediği özelliği (dinamik kod, alan adı) içermiyor.

ÇözümÖnce GET /me features değerini okuyup buna göre uyarlayın: kodu yine de oluşturun (Free planında statik olur) veya kullanıcıya planın ne gerektirdiğini bildirin.

403 insufficient_scope

NedenKapsamlar, anahtar oluşturulurken belirlenir. Düzeltmeİhtiyacınız olan kapsamlarla yeni bir anahtar oluşturun ve eskisini iptal edin. OAuth için yetkilendirme isteğinde kapsamı belirtin.

PATCH destination_data isteğinde 400 not_dynamic

NedenKod statiktir: Wi-Fi/vCard/metin türünde ya da Free planında ücretsiz dinamik kod hakkı zaten kullanıldıktan sonra oluşturulmuş bir koddur.

Düzeltmeurl/phone/email/sms/location için hesabın kullanım hakkı varken POST /codes/:id/dynamic isteği gönderin, ardından kodu yeniden indirin ve yazdırın (görsel değişir). Wi-Fi, vCard ve metin kodları hiçbir zaman dinamik olamaz; bunun yerine bir sayfayı açan url kodu oluşturun.

Slug ayarlarken 400 no_domain

NedenBağlantı adları kendi alan adınızda yer alır.

DüzeltmeÖnce Account sayfasında bir alan adı bağlayıp doğrulayın. qrflow.codes/q üzerinde yol her zaman short_code olur.

Slug için 409 conflict

NedenKodlarınızdan birinde bu ad zaten kullanılıyor.

DüzeltmeKodu bulmak için GET /codes?q= isteği gönderin veya başka bir ad seçin. Adlar genel değil, hesap başına benzersizdir.

Tarayıcı konsolunda CORS hatası

NedenAPI yalnızca sunucudan sunucuya yapılan çağrıları (ve Canva'yı) kabul eder. Bu kasıtlıdır: web sayfasındaki bir anahtar sızmış bir anahtardır.

DüzeltmeÇağrıyı bir route handler, server action, edge function veya backend içine taşıyın ve sayfadan orayı çağırın.

Görselde QRFLOW işareti var

NedenKod, oturum açmamış biri tarafından oluşturulmuştur. İşaret yalnızca anonim indirmelerde görünür.

DüzeltmeHerhangi bir hesap, ücretsiz hesaplar dahil, işareti kaldırır. Kaydedilmiş bir kodun görsellerinde bu işaret bulunmaz.

Alan adımı ekledikten sonra short_url hâlâ qrflow.codes/q/… gösteriyor

NedenAlan adı henüz doğrulanmamış veya CNAME kaydı yanlış.

DüzeltmeAccount sayfasındaki durumu ya da GET /domains yanıtını kontrol edin (durum verified olmalıdır). Doğrulandıktan sonra mevcut kodlar otomatik olarak geçiş yapar.

Bir <img> etiketinde image_url 401 hatası veriyor

NedenAuthorization başlığı gerekir; <img> bu başlığı gönderemez.

DüzeltmeAynı Code nesnesindeki svg_download_url veya png_download_url değerlerini kullanın: bunlar başlık gerektirmeden 24 saat çalışan imzalı bağlantılardır. Kalıcı bir çözüm için image_url değerini sunucunuz üzerinden proxy edin (Next.js tarifine bakın) veya short_url değerini kendiniz kodlayın.

SVG değil, PNG gerekiyor

NedenSVG'de çerçeve ve logo bulunur; PNG ise sade koddur.

DüzeltmeGET /codes/:id/image.png (bearer veya imzalı png_download_url) 256 ile 2048 px arasında bir PNG döndürür. Çerçeveli PNG için SVG'yi sharp veya resvg ile dönüştürün (sharp(svgBuffer).png().toBuffer()).

Asistanım, görsel uç noktasının isteği reddettiğini söyledi ve kodu kendisi çizdi

NedenBearer gerektiren image_url değerini aldı.

DüzeltmeArtık her kodda png_download_url ve svg_download_url bulunuyor ve get_qr_image bunları döndürüyor; asistan oturum açmadan bunları curl ile alabilir. Aynı short_url değerini kodlayan yerel olarak çizilmiş bir kod yine çalışır ve taramaları sayar, ancak çerçeve ve logo içermez.

Webhook hiç ulaşmıyor

NedenURL kuralları veya alıcı sunucu.

DüzeltmeURL, herkese açık bir sunucuda https olmalıdır (localhost, özel IP'ler ve qrflow.codes kullanılamaz). Webhook'ta Test düğmesine basın: sonuç, sunucunuzun yanıtladığı durumu gösterir. Tarama etkinlikleri toplu gönderilir ve yaklaşık beş dakika sürebilir; kontrol panelindeki code.* etkinlikleri de birkaç dakika kuyruğa alınırken API ve MCP yazma işlemleri anında iletilir.

İmza doğrulanmıyor

NedenYeniden serileştirilmiş bir gövdeyi imzaladınız.

DüzeltmeJSON ayrıştırmasından önce, aldığınız ham baytları kullanarak doğrulayın. Express'te bu rota için express.raw({ type: 'application/json' }) kullanın; Next.js App Router'da await req.text(); Flask'ta request.get_data(). Ardından ${t}.${raw}\ değerinin HMAC-SHA256 özetini hesaplayın.

Webhook kendiliğinden kapandı

NedenArka arkaya yirmi başarısızlık.

DüzeltmeAlıcı sunucuyu düzeltin, ardından yeniden etkinleştirin (Account › Webhooks üzerinden veya silip yeniden oluşturarak). Bu olduğunda size e-posta gönderilmiştir. Kuyruğa alınmış yeniden denemeler devam eder.

Yinelenen webhook teslimatları

NedenYavaş bir 2xx yanıtı (8 saniyeyi aşan) başarısızlık sayılır ve yeniden denenir.

DüzeltmeÖnce yanıt verin, sonra işleyin. Yeniden denemelerde değişmeyen payload id değerine göre yinelenenleri ayıklayın.

İçe aktarma sırasında 429 rate_limited

NedenAnahtar başına dakikada 600 istek.

DüzeltmeHer kod için ayrı bir POST yerine POST /codes/bulk kullanın (tek istekte 2.000 kod) veya Retry-After saniye sayısı kadar bekleyin.

Bir kodu sildim ve basılı posterimde artık 'Code not found' yazıyor

NedenSilme işlemi kalıcıdır ve bağlantıyı devre dışı bırakır.

DüzeltmeGeri alma yoktur. Bir dahaki sefere PATCH { paused: true } kullanın; duraklatılmış bir kod bilgilendirici bir sayfa gösterir ve yeniden etkinleştirilebilir.

Planımı düşürdükten sonra anahtarım çalışmayı durdurdu

NedenBusiness planından ayrıldıktan sonra anahtarlar 30 gün çalışmaya devam eder, ardından 402 yanıtı verir.

DüzeltmeYeniden abone olun; hiçbir şey silinmedi ve aynı anahtarlar yeniden çalışır.

Listede olmayan bir sorun mu var? Tam isteği ve aldığınız JSON hatasını hello@qrflow.codes adresine gönderin. Business hesaplarına öncelikli destek verilir.

Limitler ve adil kullanım

Limit
Anahtar başına dakikadaki istek sayısı600. Bu sınır aşılırsa Retry-After ile 429 yanıtı verilir.
Hesap başına anahtar sayısı10
Hesap başına webhook sayısı10
Kaydedilmiş kodlar (adil kullanım)Premium için 1.000, Business için 25.000; API bu sayıların iki katında durur.
Toplu işlemPremium için ayda 500 (istek başına 500); Business için ayda 10.000 (istek başına 2.000).
Bağlantı alan adlarıPremium için 1, Business için 5
TaramalarSınırsız. Premium'da kod başına ayda 100.000, Business'ta 1.000.000 taramada bilgilendirme e-postası gönderilir; hız sınırlaması uygulanmaz.
Tarama analizi aralığıİstek başına 92 gün
Liste sayfa boyutu100 (?limit=)
Etiket / açıklama / slug120 / 60 / 40 karakter
Webhook zaman aşımı ve yeniden denemeler8 saniye; 1, 5, 15, 60, 240 ve 720 dakika sonra yeniden denenir; arka arkaya 20 başarısızlıktan sonra kapatılır.
Business planından ayrıldıktan sonraAnahtarlar ve webhook'lar 30 gün çalışmaya devam eder, ardından 402 yanıtı verir. Hiçbir şey silinmez.

Adil kullanım, plan fiyatlandırmasının temelidir. Belirtilen sayıya ulaşıldığında hız sınırlaması uygulanmaz; API bu sayının iki katında durur ve önce bir çalışan size e-posta gönderir. Daha yüksek hacimler için: hello@qrflow.codes.

Güvenlik: sizin ve tarama yapan kişilerin güvenliği

QRFLOW hesabınızı nasıl korur?

  • Anahtarlar yalnızca bir kez gösterilir ve SHA-256 özeti olarak saklanır. QRFLOW'da hiç kimse anahtarı geri okuyamaz; kaybederseniz yenisini oluşturun.
  • Her istek, anahtarın ait olduğu hesapla sınırlandırılır. Başka bir hesaba ait kod kimliği 404 döndürür, asla bilgi sızdırmaz.
  • Kapsamlar her anahtar için sabittir; böylece raporlama panosu için oluşturulan bir anahtar kod oluşturamaz veya silemez.
  • Anahtar başına dakikada 600 istek; bu sınır aşılırsa herkesin yavaşlaması yerine doğrudan 429 yanıtı verilir.
  • Hedef adresler izin listesine alınır: http, https, mailto, tel, sms, geo ve sınırlı sayıda uygulama şeması (whatsapp, tg, signal, spotify, uygulama mağazaları). javascript:, data: ve file: oluşturma sırasında reddedilir; böylece güvenliği ihlal edilmiş bir entegrasyon kodlarınızı saldırı aracına dönüştüremez.
  • Webhook URL'leri herkese açık sunucularda https olmalıdır; QRFLOW özel ağları veya kendisini hiçbir zaman çağırmaz. Her teslimat imzalanır ve her payload sabit bir id içerir.
  • OAuth istemcileri PKCE S256 ile kaydolur ve belirteçler verildikleri sunucuya bağlanır; MCP sunucusu için verilen bir belirteç REST API'de yeniden kullanılamaz.
  • Herkes Account sayfasından bir anahtarı iptal edebilir veya bir uygulamanın bağlantısını kesebilir; değişiklik anında geçerli olur.

Sizin yapmanız gerekenler

  • Kaynak kodu yerine ortam değişkenleri kullanın. Bir anahtar git geçmişine girerse iptal edin.
  • Yalnızca sunucu tarafında kullanın. API tarayıcı kaynaklarını reddeder, ancak API'yi saran kendi uç noktalarınızın da kimlik doğrulaması yapması gerekir; aksi hâlde herkes sizin hesabınız üzerinden kod oluşturabilir.
  • Her entegrasyona, ihtiyaç duyduğu kapsamlarla ve entegrasyonun adını taşıyan ayrı bir anahtar verin. Böylece bir anahtarı iptal etmek yalnızca tek bir şeyi etkiler.
  • Webhook imzalarını doğrulayın ve beş dakikadan eski zaman damgalarını reddedin.
  • Kullanıcılarınızın verileri etiketlere veya hedef adreslere giriyorsa QRFLOW'un bunları sakladığını unutmayın; mümkün olduğunda kişisel verileri etiketlere koymayın.

Taramalar neleri kaydeder, neleri kaydetmez?

  • Her yönlendirmede istekten türetilen cihaz türü, ülke, şehir, yönlendiren sayfa, tarayıcı, işletim sistemi ve dil kaydedilir. Ayrıca kod + gün + IP + kullanıcı aracısının tek yönlü özeti saklanır; böylece hesap sahibi benzersiz ziyaretçileri sayabilir. Özet bir adrese dönüştürülemez.
  • Tarama yapan kişiye çerez yerleştirilmez ve IP adresi taramayla birlikte saklanmaz. Bilinen botlar ve bağlantı önizleme tarayıcıları atlanır.
  • Bir kod silindiğinde taramaları da silinir. Hesap silindiğinde her şey silinir.
  • Tam metin: https://qrflow.codes/privacy ve https://qrflow.codes/terms.

Sürümleme ve kararlılık

API, yol içinde sürümlenir: /api/v1. v1 kapsamında alanlar, uç noktalar, türler ve etkinlikler ekleriz; hiçbir şeyi kaldırmaz veya yeniden adlandırmayız. Kodunuz yanıtlardaki bilinmeyen alanları yok saymalıdır.

v1'i bozacak bir değişiklik gerekirse /api/v2 olarak yayımlanır ve v1 en az on iki ay çalışmaya devam eder. Anahtar sahiplerine kullanımdan kaldırma işlemleri 90 gün önceden e-postayla bildirilir.

MCP sunucusu araçları için de aynı kural geçerlidir: yalnızca argüman eklenir ve her araç adını korur.

API'yi sunan koddan oluşturulan /api/v1/openapi.json OpenAPI belgesi ve /llms-full.txt Markdown dosyası, bugün yayında olanları açıklar.

Geliştiricilerin sık sorduğu sorular

QRFLOW API'sini kullanmak için ödeme yapmam gerekiyor mu?

API anahtarları aylık 29 $ olan Business planıyla sunulur; aylık ödeme yapılır. MCP sunucusu (Claude, ChatGPT, Cursor, Claude Code) ve kendi uygulamanız için OAuth, oturum açma yoluyla tüm planlarda çalışır; oluşturabilecekleri kod sayısı planınıza bağlıdır. GET /catalog, GET /frames ve /preview.svg için anahtar gerekmez.

API üzerinden ücretsiz QR kodları oluşturabilir miyim?

Anahtarla oluşturamazsınız. Sade, statik bir görsel için qrflow.codes üzerindeki ücretsiz oluşturucu veya herhangi bir açık kaynaklı QR kütüphanesi işinizi görür. API; ücretli hesabın sunduğu dinamik kodlar, kendi alan adınız, analizler, toplu işlemler ve webhook'lar içindir.

API'yi tarayıcıdan çağırabilir miyim?

Hayır. Bir anahtarın web sayfasına sızmasını önlemek için tarayıcı kaynaklarını reddeder. API'yi bir route handler, server action, edge function veya backend üzerinden çağırın; sayfanız da bu bileşeni çağırsın.

Hangi görsel biçimlerini alabilirim?

Renklerinizi, çerçeveyi, açıklamaları ve logoyu içeren SVG (GET /codes/:id/image.svg, nominal olarak 256 ile 4096 px) ve sade PNG (GET /codes/:id/image.png, 256 ile 2048 px). Her ikisi de bearer veya her Code nesnesinde bulunan imzalı svg_download_url / png_download_url ile alınabilir; bu bağlantılar başlık olmadan 24 saat çalışır. MCP aracı get_qr_image, PNG'yi satır içinde ve her iki bağlantıyı da döndürür.

Bir QR kodunu yazdırdıktan sonra değiştirebilir miyim?

Evet, dinamikse (ücretli planda url, phone, email, sms, location). Yeni bir destination_data ile PATCH /codes/:id isteği gönderin; görsel değişmez, sonraki tarama yeni hedefe yönlendirilir. Wi-Fi, vCard ve metin kodları içeriklerini görselde taşır ve değiştirilemez.

short_url ile hedef arasındaki fark nedir?

short_url, görselin içindeki bağlantıdır (go.example.com/menu). Hedef, bu bağlantının yönlendirildiği yerdir (https://example.com/menu-fall). short_url değerini bir kez yazdırır, hedefi istediğiniz kadar değiştirebilirsiniz.

Kodlar kendi alan adımı kullanabilir mi?

Evet. Premium 1, Business 5 alan adı bağlayabilir; bir CNAME ekleyip Account sayfasında doğrulamanız gerekir. Business planında domain_id ile her kod için bir alan adı seçebilirsiniz. Bağlantı adları (slug), bu alan adında okunabilir yollar oluşturur.

Tarama kaydı, tarama yapan kişi hakkında neleri içerir?

İstekten alınan cihaz türü, ülke, şehir, yönlendiren sayfa, tarayıcı, işletim sistemi ve dilin yanı sıra benzersiz ziyaretçi sayımı için tek yönlü günlük bir özet. Çerez kullanılmaz ve IP adresi saklanmaz. Grafik oluşturmak için yeterli, kimseyi tanımlamak için yetersizdir. Ayrıntılar: https://qrflow.codes/privacy#scans

npm veya PyPI paketi var mı?

npm: npm install qrflow\ (https://www.npmjs.com/package/qrflow), sıfır bağımlılık, ESM ve CommonJS, tam TypeScript türleri; Node 18+, Bun, Deno ve Workers üzerinde çalışır. Her uç noktayı kapsar, 429 yanıtlarında yeniden dener ve verifyWebhook/parseWebhook içerir. Python: https://qrflow.codes/sdk/qrflow.py adresinde tek dosyalı bir istemci (yalnızca standart kütüphane) ve verify_webhook; PyPI paketi daha sonra yayımlanacak.

Claude, ChatGPT, Cursor ve Claude Code ile çalışıyor mu?

Evet. QRFLOW, https://qrflow.codes/mcp. adresinde bir MCP sunucusudur. Bağlayıcı olarak ekleyin, bir kez oturum açın ve doğal dille istekte bulunun. Oluşturma, düzenleme, duraklatma, adlandırma, toplu işlemler, analizler, görseller ve alan adları için on bir araç sunar.

Kendi kullanıcılarımın QRFLOW hesaplarını uygulamama bağlamasını sağlayabilir miyim?

Evet, OAuth 2.0 ile. /api/oauth/register adresinde bir istemci kaydedin (hesap gerekmez), kullanıcıları PKCE ile /oauth/authorize adresine yönlendirin ve API'yi onların token'ıyla çağırın. Kodlar, planları kapsamında hesaplarına kaydedilir.

Webhook'ları localhost'ta nasıl test ederim?

Geliştirme sunucunuzu bir tünelle (cloudflared veya ngrok) dışarı açın ve webhook URL'si olarak tünelin https adresini kullanın. Ardından imzalı bir ping almak için Account › Webhooks bölümünde Test'e basın. Webhook URL'leri herkese açık https adresleri olmalıdır; localhost ve özel adresler reddedilir.

Business aboneliğimi iptal edersem entegrasyonuma ne olur?

Anahtarlar ve webhook'lar 30 gün boyunca çalışmaya devam eder, ardından 402 yanıtı verir. Kodlar, taramalar ve alan adları hesapta kalır. Yeniden abone olmak her şeyi aynı anahtarlarla tekrar etkinleştirir.

API üzerinden Google yorumu, Instagram, Wi-Fi veya PDF kodunu nasıl oluştururum?

GET /catalog her türü ve alanlarını listeler. Ardından POST /codes isteğini türün type ve fields değerleriyle gönderin; şu türler için subtype ekleyin: { type: 'url', destination_data: { subtype: 'googlereview', placeId: 'ChIJ…' } }, { type: 'wifi', destination_data: { ssid, password, encryption: 'WPA' } }, { type: 'url', destination_data: { subtype: 'instagram', handle: 'acme' } }.

API bir koda logo yükleyebilir mi?

Henüz değil. Logoyu kontrol panelinde ekleyin; image.svg logoyu içerir ve has_logo, logonun mevcut olup olmadığını belirtir. Renkler, çerçeveler ve açıklamalar API üzerinden ayarlanabilir.

API kararlı mı?

v1 yalnızca ekleme yapar; hiçbir şeyi kaldırmaz veya yeniden adlandırmaz. Geriye dönük uyumsuz bir değişiklik v2 olarak yayımlanır; v1 en az on iki ay boyunca kullanılabilir kalır ve e-posta ile 90 gün önceden bildirim yapılır.

Aracılar, araçlar ve bunu okuyan asistanlar için

Makine tarafından okunabilir

Bu sayfadaki her şey, yazılımların alabileceği bir biçimde mevcuttur. Tamamı API'yi sunan koddan oluşturulur, bu nedenle hiçbir zaman güncelliğini yitirmez.

URLAçıklama
llms-full.txthttps://qrflow.codes/llms-full.txtBu referansın tamamı Markdown biçiminde: kavramlar, tüm uç noktalar, tüm MCP araçları, tarifler, sorun giderme ve SSS. Bu sayfayla aynı kaynaktan oluşturulur.
developers.mdhttps://qrflow.codes/developers.mda.md dosyasını alan araçlar için aynı belge.
llms.txthttps://qrflow.codes/llms.txtAsistanları buraya yönlendiren site dizini.
API tek sayfadahttps://qrflow.codes/qr-code-apiAPI'nin ne yaptığı, istemci tarafı kitaplığının hangi durumlarda daha iyi bir seçenek olduğu ve maliyeti. Bu referansın, geliştirmekten ziyade karar vermeye yönelik kısa özeti.
openapi.jsonhttps://qrflow.codes/api/v1/openapi.jsonOpenAPI 3.1. Postman, Insomnia, bir kod oluşturucu veya ChatGPT Action'a aktarın.
MCP sunucusuhttps://qrflow.codes/mcpAkış yapılabilir HTTP, dinamik kayıtla OAuth veya bearer olarak Business anahtarı.
server.jsonhttps://qrflow.codes/.well-known/mcp/server.jsonMCP kayıt defteri bildirimi.
OAuth keşfihttps://qrflow.codes/.well-known/oauth-authorization-serverRFC 8414 meta verileri; korumalı kaynak belgesi yanında bulunur.
npm paketihttps://www.npmjs.com/package/qrflownpm install qrflow. Tür tanımlı istemci, sıfır bağımlılık, webhook doğrulaması. Python tek dosyalı istemcisi: https://qrflow.codes/sdk/qrflow.py.
GitHubhttps://github.com/nativecodeapps/qrflow-sdkNext.js, Workers, Express, FastAPI ve Flask webhook'ları için istemciler, OpenAPI anlık görüntüsü ve çalıştırılabilir örnekler. Sorun bildirimleri ve PR'lar memnuniyetle karşılanır.

Sorularınız, fikirleriniz veya eklememizi istediğiniz bir kod türü varsa: hello@qrflow.codes. Koşullar: /terms. Gizlilik: /privacy.