twitvideo（ツイットビデオ） | 動画・写真投稿サイト twitvideo　twitter（ツイッター）でいま見たものを共有して世界を知ろう！

関連サイト旅館・ホテル・宿 を探すなら【yadotwi (やどつい)】

twitvideo OAuthEcho API 仕様

Version 1.01（改訂日2010/8/10）

本書で使用する名称等についての定義
名称 API 論理名
twitvideo Delegator(D)
TwitterClient Consumer(C)
Twitter ServiceProvider(SP)
OAuthEcho によるAPI 投稿機能について
  1. 承認された(twitvideo-consumerKey を持っている)Consumer からのファイルアップロード機能(API 利用)

    →コンシューマキーの発行に関する申込はこちら

  2. 未承認の不特定Consumer からのファイルアップロード機能(API 利用)
Twitter Consumer からのファイルアップロードメソッド仕様
  1. 概要

    Twitter のOAuth/xAuth を用いて認証されたクライアントから、twitvideo に写真及び動画を投稿できます。

  2. 利用可能な機能

    twitvideo へのコンテンツの登録。

■HTTP Method

OAuthEcho用APIのPOST先URLはフォーマット別に下記の２種類となっております。
http://api.twitvideo.jp/2/upload.xml
http://api.twitvideo.jp/2/upload.json

■Headers

X-Auth-Service-Provider (必須) TwitterAPIの認証URLを指定してください。

現時点では下記の２つのURLのみ受け付けます。

https://api.twitter.com/1/account/verify_credentials.xml
https://api.twitter.com/1/account/verify_credentials.json

X-Verify-Credentials-Authorization (必須) OAuthでTwitterAPIの認証URLをリクエストする際のAuthorizationヘッダを指定してください。

例）
OAuth realm="",
oauth_consumer_key="",
oauth_signature_method="",
oauth_token="",
oauth_timestamp="",
oauth_nonce="",
oauth_version="",
oauth_signature=""

Accept-Language 処理できる言語を指定してください。指定された言語でレスポンスを返します 現在対応している言語はja（日本語）、en（英語）です。

例）Accept-Language: ja

■Parameters

media（必須）:アップロードするファイル。
message（オプション）:アップロードするファイルに属するメッセージ。

consumerkey:twitvideoが発行したコンシューマキー。

指定するとtwitvideoの画面に「from アプリケーション名称」を表示します。指定しない場合「from api」と表示されます。
keyword:アップロードするファイルに属するキーワード。

※consumerkeyは任意ですが、アクセスが集中しているときなどはconsumerkeyが指定されていないクライアントの利用は制限されることがあります。

■対応ファイル形式

動画：.avi .wmv .flv .m4v .mov .mp4 .rm .mpeg .mpg .3gp .3g2
画像：.jpg .gif .png

■レスポンス

写真及び動画の投稿に成功した場合には、ステータスコード200 OK と共にボディにアップロードした写真及び動画のid,urlを入れて返します。

写真及び動画の投稿に失敗した場合には、クライアントエラーならステータスコード4xx系、サーバーエラーならステータスコード5xx系と共にボディにエラーコードとエラーメッセージを入れて返します。

エラーメッセージはAccept-Languageヘッダに指定された言語で返します。デフォルトは英語です。

結果 ステータスコード エラーコード エラーメッセージ（日本語） エラーメッセージ（英語）
成功 200 OK ─ ─ ─
失敗 400 Bad Request 1003 対応していないファイルの形式です It is a form of the file that doesn't correspond.
　 400 Bad Request 1004 ファイルサイズが上限を超えています The size of the file exceeds the upper bound.
　 400 Bad Request 1005 一度投稿してから1分間は再投稿できません After it contributes once, the repeated post cannot be done for 1 minute.
　 400 Bad Request 1006 投稿の上限を超えています After it contributes, the limit is exceeded.
　 400 Bad Request 1007 必須項目に不備があります There is incompleteness in the required item.
　 400 Bad Request 1008 無効なコンシューマキーです It is an invalid consumer key.
　 401 Unauthorized 4010 Twitterで認証されませんでした It was not attested with Twitter.
　 500 Internal Server Error 5000 Twitterで認証されませんでした（サーバーエラー） It was not attested with Twitter (server error).
　 503 Service Temporarily Unavailable 8000 メンテナンス中です It is maintaining it.
　 500 Internal Server Error 9999 システムエラーが発生しました The system error occurred.
投稿成功時XML 投稿成功時JSON 投稿失敗時XML 投稿失敗時JSON
<?xml version="1.0" encoding="UTF-8" ?>
<media>
<id>02IzX</id>
<url>http://twitvideo.jp/02IzX</url>
</media> 		{
"media":{
"id":"02IzX",
"url":"http://twitvideo.jp/02IzX"
}
} 		<?xml version="1.0" encoding="UTF-8" ?>
<error>
<code>8000</code>
<message>メンテナンス中です</message>
</error> 		{
"error":{
"code":"8000",
"message":"メンテナンス中です"
}
}
twitvideo管理者へのお問い合わせ

本APIに対する技術的なお問い合わせにつきましては、下記のメールアドレス宛にご連絡ください。

問い合わせ先：twitvideoカスタマーサポート

受付時間：平日10:00～18:00（休日のお問い合わせは翌営業日の対応となります）

Copyright© COZMIC Inc.×QUALIA,Ltd.