TwilのAPI
画像取得(oEmbed API)
Twilに公開されている画像とそのサムネイル画像のURLは、oEmbed APIを使って取得することができます。
このoEmbed APIを使うことで、Webページを解析することなく画像などのURLを直接取得することができます。 その結果、様々なアプリケーションに画像を直接表示する事ができるようになります。
URL scheme: http://www.docodemo.jp/twil/view/*
URL scheme: http://shlink.st/*
このスキームは、Twilからアップデートされたツイートに含まれるURLから直接画像情報を取得するための物です。
API endpoint: http://www.docodemo.jp/twil/oembed.json
Example: http://www.docodemo.jp/twil/oembed.json?url=http%3A%2F%2Fwww.docodemo.jp%2Ftwil%2Fview%2Fnorisky%2F96bba13879cc08dc949f64ef0c2a8b03%2F20110101-104748.html
Example: http://www.docodemo.jp/twil/oembed.json?url=http%3A%2F%2Fshlink.st%2FApS
注意:
- JSONフォーマットのみに対応しています。現在のところXMLフォーマットには対応していません。
- サムネイル画像は、全て100x100(pix)です。
- 写真のmaxwidthとmaxheightパラメータに100以下を指定した場合は、指定サイズに関わりなく100x100(pix)のサムネイル画像のURLが返却されます。また古い写真は、メイン画像のURLとしてサムネイルのURLが返却されます。
- 動画ファイルのmaxwidthとmaxheightパラメータは、指定しても無視されます。
- 音声ファイルは、音声を示す100x100(pix)のアイコン画像が返却されます。
oEmbed APIについては、oembed.comのドキュメントを参照してください。