Vita API
Vita API とはその名前の通り PS Vita から発展していった API です。ほかの Wii U や 3DS でも利用されており、PC 向けの Windows ストア アプリの niconico (以後この記事では WSA とします) でも一部に Vita API が使われています。
REST API としてバージョン管理されており、現在のバージョンは v1 になっています。将来的に OAuth でのアクセスも考えられるので、今から実装しておいて問題はないでしょう。
REST API としてバージョン管理されており、現在のバージョンは v1 になっています。将来的に OAuth でのアクセスも考えられるので、今から実装しておいて問題はないでしょう。
全 API に対して
- Host は api.ce.nicovideo.jp
- GET または POST、どちらでも可
- __format で json か xml を指定できる
- __context (前回の状態?) とかも発行しているっぽい (3DS)。WSA はつけてない代わりにキャッシュを働かせないために dummy=[unixtime] としている。
セッション系 API
/api/v1/session.create
これで受け取った session_key を x-nicovita-session としてヘッダーに付与
[セッション要] /api/v1/session.alive
ユーザー関連
/api/v1/user.info
- user_id
[セッション要] /api/v1/user.premium
/nicoapi/v1/user.myvideo
- from
- limit
- order/sort: ※1
- user_id
動画系 API
/nicoapi/v1/video.info
- v: 動画 ID
/nicoapi/v1/video.array
- v: 複数の動画 ID (カンマ区切り)
[セッション要] /nicoapi/v1/video.play
- v
[?] /nicoapi/v1/video.playlen
- start
- end
よくわからない。Wii U で使われいた。詳細不明。
/nicoapi/v1/video.relation
- v: 動画 ID
- from
- to
- order/sort: ※1
/nicoapi/v1/video.ranking
- genre: ※2
- span: ※3
- type: ※4
/nicoapi/v1/video.sherlock
- cmd: recommend?
- limit
/nicoapi/v1/video.ceselected
- from
- limit
- list_id: [option]
- mode: topic または vocaloid
/nicoapi/v1/wiiu.ranking
- genre: ※2
/nicoapi/v1/wiiu.trendytag
- genre: ※2
/api/v1/achieve.set
- cat: title となっていた。
- date: 20140418%2c20140331 のようになっていた。範囲版 date (?)
マイリスト関連
/nicoapi/v1/mylistgroup.get
- detail: 0 or 1
- group_id: マイリストの ID
/nicoapi/v1/deflist.list
- from
- limit
[セッション要] /nicoapi/v1/deflist.add
- description
- v
/nicoapi/v1/mylist.list
- from
- limit
- group_id
- order/sort: ※1
[セッション要] /nicoapi/v1/mylist.add
- description
- group_id
- v
/nicoapi/v1/mylist.search
- from
- limit
- order
- sort
- str
チャンネル動画関連
/nicoapi/v1/video.channelrecentvideo
- category_id
/nicoapi/v1/video.channelselected
- from
- limit
動画検索関連
/nicoapi/v1/video.search
- str: キーワード
- from
- limit
- order/sort: ※1
/nicoapi/v1/tag.search
- tag: タグ
- from
- limit
- order/sort: ※1
生放送関連
video, community は全共通データ構造。
/liveapi/v1/video.info
/liveapi/v1/video.array
[セッション要] /liveapi/v1/video.play
- v
/liveapi/v1/video.onairlist
/liveapi/v1/video.comingsoon
/liveapi/v1/video.search.solr
[セッション要] /liveapi/v1/user.subscribe
- from
- limit
スレマ関連
スレマに関しては動画とコミュニティーの両方が存在する。X には video または community を指定する。
/api/v1/step.X.ranking
- date: ※5
- from
- limit
- type: ※4
/api/v1/step.X.aroundranking
- content_id
- date: ※5
- range
/api/v1/step.X.reporter
- id
[セッション要] /api/v1/step.reportable
- sp_enabled: ステップ数報告可能か (?)
- total_sp_count: 合計ステップ数表示の有無 (?)
普通一般常識があるなら、この API には関与しないほうがよい。アプリ製作者の倫理問題だ (忠告)。
コミュニティー関連
[セッション要] /api/v1/community.info
- id
[セッション要] /api/v1/community.array
- id
[セッション要] /api/v1/comunity.list
- type: ch など
*
カテゴリー関連
/nicoapi/v1/genre.list (※2)
- group: 1 を付けるとグループ カテゴリー読み込み
all (全部) のみこの API から取得できない
その他
/api/v1/system.unixtime
UnixTime を得るだけの API
/api/v1/blog.info
- type: wiiu/3ds/vita など
※
1
order
- d: 昇順
- a: 降順
sort
- t: マイリスト登録
- a: タイトル
- c: マイリストコメント
- f: 投稿
- v: 再生
- n: コメント (日時)
- r: コメント (量)
- m: マイリスト
- l: 動画の長さ
3: span
- daily: 24 時間
- hourly: 毎時
- weekly: 週間
- monthly: 月間
- total: 合計
4: type
- fav: 総合
- view: 再生
- res: コメント
- mylist: マイリスト
5: date
- YYYY-MM-DD