公開APIのご利用について

此内容尚未翻译。

当サイトでは、一部のデータを、のりプロや VTuber 関連のウェブサービスなどでご利用いただけるよう、一部のデータを API として公開しています。

ここに掲載していないものも含め、以下を順守したうえでご利用いただけます。

  • 提供するデータはすべて自己責任でご利用ください。
  • のりプロ二次創作ガイドラインの範囲内で、良心的な方法でご利用ください。
  • のりプロ公式による利用である場合を除いて、必ず事前にご報告ください。
    お問い合わせフォーム / Twitter DM

のりプロ 外部配信取得 API Ver 1.1

のりプロ公式スケジュールで取得できない、以下の情報を取得できます。

  • のりプロ外部の YouTube チャンネルでの配信
  • BiliBili での配信
  • その他、外部 URL での配信

エンドポイント

GET https://schedule-api.noripromatome.ml/client-api/NpOutStream.json
  • メゾッド:GET
  • 資格情報:必要なし
  • ペイロード・パラメータ:なし
  • レート制限:なし(静的ファイルのため大したことはありませんが、常識的な範囲でご利用ください)

返答

HTTP 200 (成功)

Snake_case と camelCase が混在してますが気にしたら負けです

NpOutStream.json
{
    "items": [
        {
            "id": 15,
            "pf": {
                "yt": {
                    "exists": true,
                    "id": "7wo1Zv1nJhw",
                    "isLive": false
                },
                "bl": {
                    "exists": false
                },
                "url": {
                    "exists": false
                }
            },
            "stream_host": {
                "id": "outside",
                "name": "兎鞠まり",
                "channelId": "UCkPIfBOLoO0hVPG-tI2YeGg",
                "channelIcon": "https://yt3.ggpht.com/ytc/AKedOLRS0wTtVBwXKvjURwUtOXyoH0015CPdc2PSBEwBfg=s64-c-k-c0x00ffffff-no-rj"
            },
            "start_date": "2022-03-20T10:00:00+00:00",
            "stream_title": "【#わらまり】ついに始まった地獄のゲーム! スーパードンキーコング2【鬼灯わらべ/兎鞠まり】",
            "noriProMembers": [
                "hoozuki"
            ]
        },
        {
            "id": 4,
            "pf": {
                "yt": {
                    "exists": false
                },
                "bl": {
                    "exists": false
                },
                "url": {
                    "exists": true,
                    "li": "https://vtuberfesjapan.jp/",
                    "ogImage": "https://vtuberfesjapan.jp/assets/images/common/common/vfes2022_ogp.png"
                }
            },
            "stream_host": {
                "id": "outside",
                "name": "ドワンゴ"
            },
            "start_date": "2022-04-30T05:00:00+00:00",
            "stream_title": "【有料】VTuber Fes Japan Supported by Paidy DAY 2",
            "noriProMembers": [
                "inuyama",
                "shirayuki"
            ]
        },
    ],
    "lastUpdate": "2022-03-22T22:08:30+09:00",
    "apiVer": "1.1"
}
JSON 構造
KeysType備考
itemsArray配信情報の Object が入っています。
lastUpdateString最終更新日時を ISO 8601 形式で掲載しています。
apiVerStringAPI のバージョンです。このドキュメントで扱っているのは、現行のバージョン 1.1 です。
備考

Access-Control-Allow-Origin ヘッダは、対象のオリジンからのアクセスの際自動で付与されます。必要な場合はお問い合わせください。

なお、現時点で以下のオリジンで自動で付与されるようになっています。

  • http(s)://schedule.noripromatome.ml
  • http(s)://enghp.noripromatome.ml
  • http(s)://seesaawiki.jp
  • http(s)://schedule.noripro.jp
  • http://localhost:[0-9]*
  • その他

内部エラー

以下の場合、内部のプログラムにエラーが発生した可能性が高いです。

  • HTTP 200 は返るが、JSONが全く出力されない
  • lastUpdate の時間が、リクエスト時刻の20分以上前になっている

このAPIはのりプロ非公式スケジュールと同じように15分周期で更新されますので、エラーが発生した場合でも次の更新で解決している場合があります。


リファレンス

配信情報 Object 構造

Keys Type 備考
id Integer 内部管理用のIDです。1日おきにリセットされるものなので一時的な判別にしか使えません。
pf Object 配信先プラットフォームに関する情報を掲載しています。
yt
bl
url
Object YouTube
BiliBili
外部URL
での配信状況の詳細を掲載しています。
exists Boolean そのプラットフォームでの配信があるかを示しています。trueの場合はそのプラットフォームでの配信があり、同じObject内に詳細が記載されます。
yt id String YouTubeの配信IDが記載されます。
isLive Boolean YouTubeで配信中かどうかが記載されます。
YouTube Data APIの liveBroadCastContent と書式を統一する可能性もあります。
bl url String BiliBili 生放送の URLが記載されます。
url li String 外部URLが記載されます。チケットの案内ページ・視聴画面・もしくは公式サイトへのリンクになります。
ogImage String | null ページにOpen Graph画像がある場合は、そのURLが記載されます。取得に失敗したり、画像がなかったりした場合は null となります。
stream_host Object 配信の主催者に関する情報が記載されます。
id String (streamHostId) 配信の主催者のstreamHostIdが記載されます。のりプロ外のメンバーの場合は outside と記載されます。
name String stream_host.id が outside の場合のみ。
配信の主催者名が記載されます。
channelId String stream_host.id が outside かつ pf.yt.exists が true の場合のみ。
配信の主催者のYouTubeチャンネルIDが記載されます。
channelIcon String stream_host.id が outside かつ pf.yt.exists が true の場合のみ。
配信の主催者のYouTubeチャンネルのアイコンURLが記載されます。
start_date String 配信の開始時刻が ISO 8601 形式で記載されます。
noriProMembers Array (streamHostId) 出演するのりプロメンバーの streamHostId が羅列されます。

streamHostId 一覧表

基本的に、のりプロ公式HPのURLに準拠しています。

streamHostId 名前
norio 佃煮のりお
inuyama 犬山たまき
shirayuki 白雪みしろ
enomiya 愛宮みるく
kumagaya 熊谷タクマ
himesaki 姫咲ゆずる
beppy べっぴー
hoozuki 鬼灯わらべ
lovechan らぶちゃん
muse ミューズ
temari 手鞠カルタ
nekozeno 猫瀬乃しん
inari 稲荷いろは
reglush レグルシュ・ライオンハート
outside のりプロ外タレント(noriProMembers Array 内には含まれません)