ForHosting KIT · サイト取得・監視

URL・WiFi・vCard・SMS・メール用QRデータを作成

QR画像はテキストデータを視覚的に符号化したものであり、内容の種類ごとに決まった書式があります。この生成ツールは、通常の入力項目からWebサイト、WiFiネットワーク、vCard連絡先、SMS、メール下書きに対応する符号化可能な文字列を作成します。選択した形式に必要な区切り、エスケープ、改行、URIエンコードを適用し、QRライブラリ、画像サービス、印刷工程、自動テストへそのまま渡せる再現性のある結果を返します。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

項目を入力する前にデータ形式をお選びください

読み取り後に実行してほしい操作に合うデータ形式から始めます。URL形式には有効な絶対HTTPまたはHTTPSアドレスを指定し、多くのカメラアプリはこれをブラウザーで開きます。WiFi形式にはネットワーク名、セキュリティ方式、必要な場合のパスワード、任意の非公開ネットワーク設定を含めます。vCardは再利用できる連絡先情報です。SMSには宛先番号と任意の定型文、メールには宛先と任意の件名および本文を指定します。必須項目は選択した形式だけで決まるため、WiFiデータの作成時にメールアドレスを求めることはありません。必要な値が欠けている場合は、入力不正を明確にお知らせします。この条件付きの入力仕様により、不完全なQRデータを気付かず作ることなく、フォームや自動処理で同じ機能をご利用いただけます。結果には正規化された種類と完成した文字列が含まれますが、画像の描画、宛先への連絡、宛先の存在確認は行いません。

予約文字の処理方法をご確認ください

QRデータ形式では句読記号を構造として使うため、入力された一部の記号を保護する必要があります。WiFi形式はプロパティをセミコロンで区切り、名前と値をコロンで分けます。ネットワーク名やパスワード内のバックスラッシュと予約記号はエスケープされ、新しいプロパティではなくデータとして保持されます。vCardテキストでは、バックスラッシュ、コンマ、セミコロン、改行に専用のエスケープを適用し、バージョン3.0のフィールドとCRLF改行でカードを組み立てます。メールはmailto URIとして表現します。件名と本文はクエリ値として符号化されるため、空白、アンパサンド、改行、非ASCII文字がクエリ構造を変えることはありません。SMSには、多くのQRリーダーが対応する簡潔なSMSTO形式を使用します。処理は形式ごとに異なり、すべてを一般的なURLエンコードにするとWiFiやvCardの構文が壊れ、メールのクエリを符号化しなければ読み取り内容が変わる可能性があります。

返された文字列をエンコーダーやテストでご利用ください

返されたデータ文字列は変更せず、QRエンコーダーのテキスト入力へ渡してください。エンコーダー側でデータとして扱い、誤り訂正レベル、画像サイズ、余白、出力形式を選びます。これらの見た目に関する設定はデータ作成とは別です。工程を分けると、同じ正規データからSVG、PNG、PDF、ラベルプリンター、モバイルアプリ向けの出力を作成でき、業務ルールの重複を防げます。テストも容易になり、代表的な入力を保存して、画像生成前にvCardの改行やエスケープ済みWiFi区切りを含む文字列全体を比較できます。読み取り結果が想定外の場合は、まず文字列を確認し、その後エンコーダー設定とリーダーの対応状況をご確認ください。処理は決定的で、ネットワーク、乱数、時刻を使用しません。単発の作業はブラウザーが便利です。APIは1回$0.002で、バッチ処理、テンプレート、配備パイプライン、サーバーアプリに適しています。

活用例

WiFi案内カードを準備

掲示物、客室、案内セット用の接続QRを描画する前に、予約文字を処理したネットワークデータを作成します。

連絡先ラベルを生成

連絡先項目をvCard 3.0データへ変換し、名札、カード、商品同梱物へ符号化します。

QR処理工程を検証

画像描画や実機読み取りとは分離して、URL、SMS、メールの正確なデータ文字列を検証します。

よくある質問

このツールでQRコード画像を作成できますか？

いいえ。別のQRエンコーダーへ渡すためのデータ文字列を作成します。

料金はいくらですか？

このページのブラウザーでは無料で実行でき、APIは1回$0.002でご利用いただけます。

対応するWiFiセキュリティ方式は何ですか？

WPA、WEP、nopassに対応します。WPAとWEPにはパスワードが必要ですが、nopassには不要です。

どのvCardバージョンが生成されますか？

構造化氏名、表示名、指定された任意の連絡先項目を含むvCard 3.0を生成します。

メールの件名や本文に空白や改行を含められますか？

はい。mailtoのクエリ値として符号化し、予約文字と改行を意図した内容のまま保持します。

URL、電話番号、ネットワーク、メールボックスを確認しますか？

いいえ。必要な形式は端末内で検証しますが、外部サービスへの接続や宛先の存在確認は行いません。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/web/qr-payload-build

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/web/qr-payload-build \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"wifi"}'

const res = await fetch("https://api.kit.forhosting.com/web/qr-payload-build", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "type": "wifi"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/web/qr-payload-build",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "type": "wifi"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/web/qr-payload-build", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"type":"wifi"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"type":"wifi"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/web/qr-payload-build", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "type": "wifi"
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "web.qr_payload_build",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

制限

`timeout_sec`	30
`max_crawl_pages`	25

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

KITの完全なドキュメントを見る →