一括リンク作成

このAPIでは、複数の短縮リンクを一度に作成できます。
大量にリンクを作成したい場合は、ダッシュボードの「大量リンク作成」メニューをご利用ください。

プランによって1回のリクエストで作成できるリンク数に制限があります。
より多く作成するには、このAPIを複数回に分けて呼び出す必要があります。

  • パーソナルプラン:最大100件
  • プレミアムプラン:最大200件
  • ビジネスプラン:最大300件

このAPIはパーソナルプラン以上でご利用いただけます。

Http Header
POST /api/link/v1/createBulk
Host: https://vivoldi.com
Authorization: APIKey {Your API Key}
Content-type: application/json
User-agent: {Your User-agent}
Accept-Language: en
Request
{
	"links": [
		{
			"url": "https://google.com",
			"domain": "https://vvd.bz"
		},
		{
			"url": "https://facebook.com",
			"domain": "https://vvd.bz"
		},
		{
			"url": "https://twitter.com",
			"domain": "https://vvd.bz"
		}
	]
}
フィールドタイプ
links
フィールドフィールドの説明説明必須タイプ
url長いURL 生成された短いリンクをクリックしたときに移動する長いURLです。
最大3,000 bytesまで設定できます。
string
domainドメイン 値が空の場合、自動的にvvd.bzドメインに設定されます。
“「https://”値を含めて設定する必要があり、“brandLinkId”オプションが“Y”の場合、ドメインは“https://vvd.im”に設定してください。
あなたが所有したドメインをVivoldiと連動した場合、そのドメインを設定します。
例: https://vvd.bz
string
redirectTypeRedirect方法 短いURLから長いURLに移動する方法を設定します。
HTTPのステータス応答コードとして200、301、302のいずれかを選択することができます。デフォルト値: 302
Redirect方法の詳細は「用語まとめ」ページで確認してください。
int
grpIdxグループID グループIDを設定すると、そのグループにリンクが生成されます。
グループIDを確認するには、「グループリスト」APIを呼び出して確認する必要があります。
int
brandLinkIdブランドリンクID 値を指定すると、そのIDでリンクが生成されます。
(ブランドリンクが設定されている場合、ドメインはvvd.bzではなくvvd.imです)
値が空の場合、リンクIDは自動的に生成されます。
string
ttlリンクタイトル 値が空の場合、長いURLのウェブページのタイトルとして保存されます。
値が空の場合、長いURLにアクセスしてHTMLの解析作業が行われるため、API呼び出し後の応答速度が遅い場合は、タイトルを設定してください。
string
descriptionMetaの内容 「redirectType」の値が「200」のとき、ページのメタタグであるdescriptionを設定することができます。
「redirectType」の値が「301」、「302」の時はこの値は無視されます。
string
metaImgメタ画像 リダイレクトタイプが「200」の場合のみ、メタ画像タグを設定できます。
メタ画像の値は、URL形式で「https://」で始まる必要があります。
リダイレクトタイプが「301」または「302」の場合、値は無視されます。
string
memoメモ ユーザーに公開されず、管理に必要な付加情報を設定することができます。 string
notfSubscYnプッシュリンク 値がYの場合、生成されたリンクをクリックすると、長いリンクに移動する前にWebプッシュ通知ポップアップが表示され、ユーザーがプッシュ通知を許可した場合、許可したすべてのユーザーにプッシュメッセージを送信することができます。
通知ポップアップに同意しないか、キャンセルする場合、すぐに元の長いURLに移動します。
値を入力しない場合、デフォルト値はNです。
プッシュサブスクリプションリンクの詳細については、「Webプッシュ機能紹介」ページをご覧ください。
Y or N
pushNotifyYnクリック数プッシュ通知 値がYの場合、「設定 -> 環境設定」ページのリンク設定で設定されたリンククリック数に達するたびに、Vivoldiアプリがインストールされたモバイルデバイスにクリック数プッシュ通知を受け取ることができます。
この機能はパーソナルプランから利用できます。
Y or N
mailNotifyYnクリック数メール通知 値がYの場合、「設定 -> 環境設定」ページのリンク設定で設定されたリンククリック数に達するたびに、Vivoldiに登録されたメールでクリック数情報を受け取ることができます。
この機能はパーソナルプランから利用できます。
Y or N
delYmdリンク削除日 設定した日付が過ぎると、リンクがシステムによって自動的に削除されます。
削除周期: 1時間ごと
はい: 2025-12-31
Date
array
 
Response
{
	"code": 0,
	"message": "",
	"result": [
		{
			"shortUrl": "https://vvd.bz/bbuR",
			"url": "https://google.com"
		},
		{
			"shortUrl": "https://vvd.bz/bbuS",
			"url": "https://facebook.com"
		},
		{
			"shortUrl": "https://vvd.bz/bbuT",
			"url": "https://twitter.com"
		}
	]
}
フィールド説明タイプ
codeレスポンスコードです。0は成功、それ以外は失敗を示します。int
messageレスポンスメッセージです。codeが0でない場合にエラー内容が含まれます。string
resultレスポンスデータです。要求数に応じて生成された短縮URLの配列を返します。array