QRコード生成API

Request Parameters

domain string required

Default:https://vvd.bz

リンクドメイン。 デフォルトは https://vvd.bz です。brandLinkId を設定すると、ドメインは https://vvd.im に切り替わります。
カスタムドメインを使用する場合は、該当ドメインを指定できます。

type string required

Default:url

Enum:

urltextphone

QRコードの種類。

• url: WebページURL
• text: テキスト
• phone: 電話番号

タイプに応じて必要なフィールドが異なるため、対応する値を設定してください。

url string

QRコード読み取り時の遷移先URL。 type が url の場合は必須で、http または https の完全なURLを入力してください。
最大 2,000 bytes。

text string

QRコードに埋め込むテキスト。 type が text の場合に使用し、読み取り時にそのまま表示されます。
メッセージやコードなどに活用でき、表示形式はデバイスにより異なる場合があります。
最大 65,535 bytes。

phone string

QRコード読み取り時に発信される電話番号。 type が phone の場合に使用され、端末の発信画面が開きます。
最大 32文字。国番号付きの形式を推奨します。

logoType string

Default:N

Enum:

NCU

QRコード中央に配置するロゴの種類。

• N: ロゴなし
• C: 組織設定のデフォルトロゴ
• U: カスタムロゴ

ロゴを追加するとブランド認知が向上します。本機能はパーソナルプラン以上で利用可能です。

logo string

QRコード中央に表示するロゴ画像URL。 logoType が U の場合に使用します。外部公開されたURLを指定してください。
正方形・透過PNGを推奨。最大サイズは500x500pxです。

foreground string

QRコードの前景色（HEX形式）。デフォルトは黒。
背景とのコントラストを十分に確保してください。
デフォルト: #000000FF

background string

QRコードの背景色（HEX形式）。デフォルトは白。
暗すぎる背景は認識率が低下する可能性があります。
デフォルト: #FFFFFFFF

markerColor string

位置検出マーカーの色。視覚的に強調可能。
デフォルト: #000000FF

markerBorderColor string

マーカーの枠線色。低コントラストは認識に影響します。
デフォルト: #000000FF

style string

QRコードの全体スタイル。ダッシュボードで確認可能。

markerStyle string

マーカーの形状スタイル。複数のデザインをサポート。

grpIdx integer

グループ識別子。リンク管理に使用します。

brandLinkId string

未設定時は自動生成。デフォルトドメインは https://vvd.im。

ttl string

内部管理用タイトル。

memo string

内部メモ（ユーザー非表示）。

qrBypassYn string

Y: 直接遷移（トラッキングなし）
N: 短縮リンク経由（トラッキングあり）

pushNotifyYn string

スキャン時のプッシュ通知設定。

mailNotifyYn string

スキャン時のメール通知設定。

delYmdt datetime

削除予約日時。指定時刻後に自動削除。