[Web API]
heartbeat
ハートビート。定期的に叩く必要がある。
リクエスト URL
GET http://live.nicovideo.jp/api/heartbeat?v={live_id}
- live_id
ID
データ形式
XML 形式。
データサンプル
正常な場合
<?xml version="1.0" encoding="UTF-8"?>
<heartbeat status="ok" time="1391555375">
<watchCount>15</watchCount>
<commentCount>13</commentCount>
<is_restrict/>
<ticket>20929324:lv168235211:0:1391555375:1af6f72ef86eb766</ticket>
<waitTime>90</waitTime>
</heartbeat>
よくわからない場合
<?xml version="1.0" encoding="UTF-8"?>
<heartbeat status="fail" time="1391555422">
<error>
<code>UNKNOWN</code>
<description>unknown error, retry later</description>
<reject>false</reject>
</error>
</heartbeat>
ログインしていない場合
<?xml version="1.0" encoding="utf-8"?>
<heartbeat status="fail" time="1391558373">
<error>
<code>NOTLOGIN</code>
<description>not login</description>
<reject>true</reject>
</error>
</heartbeat>
ストリームが見つからない場合
<?xml version='1.0' encoding='utf-8'?>
<heartbeat status="fail" time="1392681799">
<error>
<code>NOTFOUND_STREAM</code>
<description>stream not found</description>
<reject>true</reject>
</error>
</heartbeat>
スロットが存在していない場合
<?xml version="1.0" encoding="UTF-8"?>
<heartbeat status="fail" time="1391555399">
<error>
<code>NOTEXIST_SLOT</code>
<description>slot doesn't exist</description>
<reject>true</reject>
</error>
</heartbeat>
スロットが見つからない場合
<?xml version="1.0" encoding="UTF-8"?>
<heartbeat status="fail" time="1392681556">
<error>
<code>NOTFOUND_SLOT</code>
<description>lost slot</description>
<reject>true</reject>
</error>
</heartbeat>
更新履歴
2014/2/18 エラーの種類を追加
2014/2/6 記述
2014/2/6 記述