サイトのトップへ戻る

Twitter 開発者 ドキュメント日本語訳

Vine oEmbed API

oEmbed互換形式でフルURLや動画IDを指定して、Vine動画一つ用のシンプル形式の埋め込み HTMLを返します。

Vine 動画のマークアップは、cache_age応答パラメタによって設定されたキャッシュライフライムまでの間あなたのサーバにキャッシュされます。



リソースURL

https://vine.co/oembed.{format}



リソース情報

応答形式
JSON
XML
認証は必要ですか?
いいえ
速度制限はありますか?
いいえ


クエリーパラメータ

リクエストの際には、id パラメータか urlパラメータのどちらかは 必ず設定しなければなりません。 両方を設定する必要はありません。

id 必須

希望するVine 動画のID。

サンプル値: Ml16lZVTTxe

url 必須

埋め込みたいVine 動画のURL。

サンプル値:

https://vine.co/v/Ml16lZVTTxeにあるVineを埋め込むには、これを使用します: https%3A%2F%2Fvine.co%2Fv%2FMl16lZVTTxe

maxwidth

表示する埋め込み領域の最大横幅をピクセル単位で設定します。

サンプル値: 500

maxheight

表示する埋め込み領域の最大高さをピクセル単位で設定します。

サンプル値: 500

omit_script

応答にVine 埋め込み JavaScriptを含めない。



リクエスト例

GET

https://vine.co/oembed.json?url=https%3A%2F%2Fvine.co%2Fv%2FMl16lZVTTxe



応答結果の例

{
  "version": 1.0,
  "type": "video",
  "cache_age": 3153600000,
  "provider_name": "Vine",
  "provider_url": "https://vine.co/",
  "author_name": "The White House",
  "author_url": "https://vine.co/u/944054069482373120",
  "title": "Marine One, ready for takeoff.",
  "thumbnail_url": "https://v.cdn.vine.co/r/thumbs/3A1E5CC27C1116110482407841792_2.5.1.13603721890676705621.mp4.jpg?versionId=_B5dDtCI.ZNd_JLK_.sFmfpQq44iXdey",
  "thumbnail_width": 480,
  "thumbnail_height": 480,
  "html": "<iframe class="vine-embed" src="https://vine.co/v/Ml16lZVTTxe/embed/simple" width="600" height="600" frameborder="0"><\/iframe><script async src="//platform.vine.co/static/scripts/embed.js"><\/script>",
  "width": 600,
  "height": 600
}