クイックスタート
1 分以内に初めてのダイナミック QR コードを作成しましょう。MostlyQR コードはダイナミックです。QR を 1 度印刷したら、その後は永遠にリダイレクト先を変更でき、スキャン分析が組み込まれています。ほとんどの人はダッシュボードを使用します。このガイドは REST API 用です。
# 1. API キーを取得
アプリの Settings → API keys でキーを作成します。キーは mtq_live_… (本番環境)または mtq_test_… (テスト)のような形式です。すべてのリクエストで Bearer トークンとして送信します。認証を参照してください。
# 2. ダイナミックリンクを作成
curl https://mostlyqr.com/api/v1/links \
-H "Authorization: Bearer mtq_live_…" \
-H "Content-Type: application/json" \
-d '{ "destination_url": "https://northbrew.co/spring-menu", "title": "Spring menu" }'
{
"code": "AZ4K9",
"short_url": "https://mqr.sh/AZ4K9",
"destination_url": "https://northbrew.co/spring-menu",
"title": "Spring menu",
"status": "active"
}
short_url を QR に変換します(任意のジェネレータを使用するか、ダッシュボードビルダーを使用)して印刷します。スキャンのたびに 302 リダイレクトでリダイレクト先に飛び、スキャンが計測されます。
# 3. リダイレクト先を変更 — 再印刷不要
curl -X PATCH https://mostlyqr.com/api/v1/links/AZ4K9 \
-H "Authorization: Bearer mtq_live_…" \
-H "Content-Type: application/json" \
-d '{ "destination_url": "https://northbrew.co/summer-menu" }'
既に印刷されたすべてのコピーは直ちに新しい URL に解決されます。コードは決して有効期限切れにはなりません — 支払いを停止しても、404 になる代わりに最後のリダイレクト先でフリーズします。
# 4. スキャンを読む
curl "https://mostlyqr.com/api/v1/links/AZ4K9/analytics?range=30d" \
-H "Authorization: Bearer mtq_live_…"
完全な形状(地理情報、デバイス、時間)については、分析を参照してください。
# 次のステップ
- ダイナミックリンク —
/v1/linksエンドポイントのすべてのオプション。 - バッチ — 1 つの呼び出しで数千のコードを作成。
- シリアライズされたコード — 物理ユニットごとの一意のコード(Enterprise)。
- 検証 — 公開「これは本物か?」チェック。
- 完全な API リファレンス。