Web将軍 QRサービス

概要

URLや文字列から QRコード画像（SVG / PNG） を生成して返すAPIサービスです。

• サービスURL: https://qr.expert-g.cloud/

---

エンドポイント

メソッド	パス	内容
GET	/qr/{data:path}	QRコード画像生成（メイン）
GET	/	使い方ドキュメント（簡易生成ツール付き）
GET	/icons	中央アイコン用 Expert Icons 名一覧
GET	/health	ヘルスチェック

基本的な使い方

データ部分は URLエンコードして渡します（/ は %2F、? は %3F）。

GET https://qr.expert-g.cloud/qr/https%3A%2F%2Fwww.e-e.company

デフォルトは SVG（image/svg+xml）で返ります。

PNGで受け取る

クエリに format=png を付与すると PNG（image/png）で返ります。

GET https://qr.expert-g.cloud/qr/https%3A%2F%2Fwww.e-e.company?format=png
GET https://qr.expert-g.cloud/qr/https%3A%2F%2Fwww.e-e.company?format=png&size=512

解像度は scale（1モジュールあたりのピクセル数）または size（目標px・scaleより優先）で調整します。

クエリパラメータ

パラメータ	型	デフォルト	説明
format	svg | png	svg	出力フォーマット。不正値は svg へフォールバック
scale	int (≥1)	10	1モジュールあたりのピクセル数（上限あり）
size	int (≥16)	なし	出力画像の目標サイズ(px)。指定時は scale より優先（上限あり）
ec	L | M | Q | H	M（icon指定時 H）	誤り訂正レベル
color	色名/HEX	000000	前景色
bgcolor	色名/HEX/transparent	ffffff	背景色。transparent で背景なし
border	int (0-20)	4	静止域（quiet zone）のモジュール数
icon	アイコン名	なし	中央に表示する Expert Icons アイコン（https://qr.expert-g.cloud/icons で一覧取得）
iconColor	色名/HEX	000	中央アイコンの色
cacheSeconds	int	設定値	CDN向け Cache-Control の max-age 上書き

例

# 色指定
GET https://qr.expert-g.cloud/qr/https%3A%2F%2Fwww.e-e.company?color=blue&bgcolor=fff

# 中央にアイコン（誤り訂正は自動でHになり読み取り性を確保）
GET https://qr.expert-g.cloud/qr/https%3A%2F%2Fwww.e-e.company?icon=wss

# アイコン色を指定
GET https://qr.expert-g.cloud/qr/https%3A%2F%2Fwww.e-e.company?icon=e-enterprise&iconColor=blue

# 背景透過のPNG
GET https://qr.expert-g.cloud/qr/https%3A%2F%2Fwww.e-e.company?format=png&bgcolor=transparent

中央アイコンについて

• 中央アイコンには Expert Icons を利用できます（アイコン名は /qr/{data}?icon=名前）。
• アイコン指定時は誤り訂正が自動的に H（復元率約30%）になり、読み取り性を確保します。
• PNG + アイコンの組み合わせは、サーバ側でラスタライズ用の追加依存（cairosvg）が必要です。未導入環境では 422 を返します。

ライセンス

本サービスはエキスパートエンタープライズサブスクリプションサービスで提供されます。

• ライセンス詳細: LICENSE

サービス

• エキスパートエンタープライズサブスクリプションサービス

会社情報

• 株式会社エキスパートエンタープライズ
• 株式会社エキスパートソフトウェア