エキスパートエンタープライズサブスクリプションサービス - QR生成API
https://qr.expert-g.cloud/
sonohara
45cb73b80e
ESS_service管理リポジトリのテンプレートから生成した顧客向けドキュメントを配信。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01BHdvDKH1bky89RMR7Zn5qr |
||
|---|---|---|
| LICENSE | ||
| llms.txt | ||
| README.md | ||
エキスパートエンタープライズサブスクリプションサービス 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