NAV
javascript

JR東日本運行情報API

JR東日本運行情報APIへようこそ。 このAPIではリアルタイムでJR東日本の運行情報をJSON形式で配信しています。 データに関しては常に正確である保証はなく、また、予告なくサーバーが停止する場合がありますのでご注意ください。

レート制限について

サーバー全体に負荷がかかるのを防ぐため、レート制限を設定しています。 現在はは毎分10リクエストまでとしています。

情報の更新頻度

1分ごとに運行情報を更新します。そのため、更新後1分以内に複数取得しても同じデータが返ってきます。

利用規約

本APIを利用した場合、API利用規約に同意したものとみなします。

運行情報API

エリアごとの運行情報の取得

fetch("https://jre-o.csm.v.ua/api/v1/operation-info/<region>").then(async (res) => {console.log(await res.text())});

出力はこのようになります:

{
    "success": true,
    "data": [
      {
        "name": "路線１",
        "id": "line1",
        "areaNames": [
          "路線"
        ],
        "isNormal": true,
        "status": "平常運転",
        "infos": []
      },
      {
        "name": "路線２",
        "id": "line2",
        "areaNames": [
          "路線"
        ],
        "isNormal": false,
        "status": "運転見合わせ",
        "infos": [
        {
            "status": "運転見合わせ",
            "message": "現在運転を見合わせております。"
          }
        ]
      },
    ]
    "updateAt": 1234567890123
}

このAPIは指定された地域の運行情報を取得します。

HTTP Request

GET https://jre-o.csm.v.ua/api/v1/operation-info/<region>

URL Parameters

Parameter Description 利用可能な値
region 地域 kanto, tohoku, shinetsu

バージョン取得

fetch("https://jre-o.csm.v.ua/api/v1/version").then(async (res) => {console.log(await res.text())});

出力はこのようになります:

{
  "success": true,
  "data": { 
    "backend": "1.0.0", //APIのバージョン
    "frontend": "1.0.0" //サーバーのバージョン
  }
}

このAPIはAPIと処理サーバーのバージョンを取得します。

HTTP Request

GET https://jre-o.csm.v.ua/api/v1/version

エラー

エラーが発生した際には下記の表をご参照ください。

Error Code Meaning
400 Bad Request -- リクエストに不正があります。
404 Not Found -- APIが見つかりませんでした。
405 Method Not Allowed -- GET以外の方法でアクセスすると表示されます。
429 Too Many Requests -- レート制限にかかっています。
500 Internal Server Error -- サーバー内でデータの取得に失敗している際表示されます。
502 Bad Gateway -- サーバーが落ちている状況です。 (このエラーのみJSONではない形式で返答されます)
503 Service Unavailable -- サービス提供時間外、またはデータの取得元でエラーが発生しています。

本APIに関するお問い合わせはすべてこちらにお願いしています。DM等で直接連絡を頂いても対応いたしかねます。

Made by chasyumen

javascript