共通仕様（XML形式）
@niftyビデオ共有から提供しているXML形式のAPIについて共通項目と、エラーについて詳しくご説明します。
要求メッセージ
要求メッセージの形式について説明します。
- パラメータはフォームパラメータ形式です。
- リクエストパラメータの文字コードは「Shift_JIS(Windows-31J)」です。
- クライアントは要求メッセージをGETまたはPOSTメソッドを使って送信します。
応答メッセージ
応答メッセージの共通部分の構造を以下に示します。
- レスポンスヘッダのContent-Typeは「application/xml」です。
- レスポンスデータの文字コードは「Shift_JIS(Windows-31J)」です。
- フォーマットはXMLとなっています。
- Root要素はresponseであり、responseには以下の二つの要素を含みます。
| パラメータ | 説明 |
|---|---|
| status | レスポンスのステータスコード(code)、ステータスメッセージ(message)、言語情報(language)を示します。ステータスについてはステータスコードを参照してください。 |
| result | 結果をセットします。内容はAPI毎に個別に規定されているので、各APIの説明をご参照ください。 |
以下に応答メッセージの例を示します。
ステータスコード
APIの処理結果として以下の応答ステータスとメッセージを返送します。
また、HTTPの応答ステータスコードにも同じ値が設定されます。
| コード | 説明 | メッセージ |
|---|---|---|
| 成功。 | OK | |
| パラメータの値が不正な場合や、想定されていないパラメータなど、渡されたパラメータがWebサービスで期待されたものと一致しない場合に返されます。メッセージにはエラーの原因を表示します。 | （例：APIのパラメータが不正です。） | |
| 該当するビデオが見つからない場合、またはURLが不正で見つからない場合などに返されます。 | データが見つかりません。 |
APIのバージョンについて
- APIのURL内に「-{バージョン番号}」を含む形式になっています。
- 例: http://api.video.nifty.com/cs/catalog/video_metadata/listapi-v1/efg_0/1.xml
- 「バージョン番号」はAPI実装のメジャーバージョンを表しています。
- メジャーバージョン内では機能拡張を行いますが、後方互換性(以前の仕様にもとづいたリクエストに対しては、機能拡張後も同様のレスポンスを返す)を確保します。
その他共通仕様
上記以外の共通仕様を説明します。
- ・日付情報には「ISO 8601」形式を使用しています。(例:2007-06-28T06:30:35+09:00)
- ・XMLの要素名に含まれるアルファベットはすべて小文字です。
- ・XMLの要素値に含まれるASCII以外の文字列には<![CDATA[]]>を用います。
- ・XMLの要素値に真偽値が含まれる場合、真ならばtrue、偽ならばfalseを用います。
- ・レスポンス中の任意のXML要素内に出現する子要素は特に明言しない限り、そのデータの公開日時順となります。
- ・ご自分のユーザーIDは、@niftyビデオ共有サービスにログイン後、マイページURL中にある〜/uid_*************/〜の*************が該当します。
例： @niftyビデオ共有さんのマイページ「http://video.nifty.com/cs/user/video_profile/detail/uid_0000000310/1.htm」
この場合、ユーザーIDは「0000000310」になります。
