回数券詳細


 Attention!

This page has not been translated into English yet. It is possible that some parts of description may contains old information. Please see Japanese Documents if you need the latest and accurate information.

「駅すぱあと」の保持する回数券の詳細な情報を取得します。 回数券一覧で取得した回数券の名称ResultSet / Coupon / Nameを指定すると、回数券の詳細を取得できます。 経路シリアライズデータを指定すると、その経路で利用可能な回数券の詳細を取得できます。

GET /v1/{format}/coupon/detail

parameters

Name Type Description
format string レスポンスのデータ形式の指定。必須
指定できる値:
- xml: xml形式のデータ
- json: json形式のデータ
※クエリパラメータではなくパスに値を指定します。
key string アクセスキー 。必須
name string 回数券名称。serializeDataと排他。serializeData無指定時必須。
Example: 新幹線回数券(自由席)
serializeData string 経路シリアライズデータ。nameと排他。name無指定時必須)。
checkEngineVersion string 完全な経路シリアライズデータの再現を行う場合は、シリアライズデータ作成時のエンジンバージョンと再現時のエンジンバージョンが同一かのチェックを有効にします。エンジンバージョンが異なる場合は、エラーを返します。省略可。
指定できる値:
- true: チェックする
- false: チェックしない
Default: true

response

Name Description
ResultSet レスポンスの最下部を表す要素
ResultSet / apiVersion WebAPIバージョン
ResultSet / engineVersion エンジンバージョン
ResultSet / Coupon 回数券を表す要素
ResultSet / Coupon / index インデックス
※ jsonデータ形式のレスポンスにインデックスは含まれません。JSON形式のレスポンスデータを利用する際の注意事項
ResultSet / Coupon / Detail 回数券の詳細な情報を表す要素
ResultSet / Coupon / Detail / Count 枚数を表す要素
ResultSet / Coupon / Detail / Direction 回数券の設定区間の方向を表す要素
- Both: 両方向で利用可能
- Define: 定義された方向のみ利用可能
ResultSet / Coupon / Detail / Price 金額を表す要素
ResultSet / Coupon / Detail / Price / Amount 合計金額を表す要素
ResultSet / Coupon / Detail / ValidPeriod 有効期限を表す要素
単位: month
ResultSet / Coupon / Name 回数券名称に区間の情報を合わせた名称を表す要素

example

GET /v1/xml/coupon/detail?key=アクセスキーを入力してください&name=新幹線回数券(自由席)
<?xml version="1.0" encoding="UTF-8"?>
<ResultSet apiVersion="1.27.0.0" engineVersion="202210_01a">
  <Coupon index="1">
    <Name>新幹線回数券(自由席):東京:新横浜</Name>
    <Detail>
      <Direction>Both</Direction>
      <ValidPeriod>3</ValidPeriod>
      <Price>
        <Amount>7860</Amount>
      </Price>
      <Count>6</Count>
    </Detail>
  </Coupon>
  <Coupon index="2">
    <Name>新幹線回数券(自由席):東京山手線内:小田原</Name>
    <Detail>
      <Direction>Both</Direction>
      <ValidPeriod>3</ValidPeriod>
      <Price>
        <Amount>16800</Amount>
      </Price>
      <Count>6</Count>
    </Detail>
  </Coupon>
  <Coupon index="3">
    <Name>新幹線回数券(自由席):東京都区内:熱海</Name>
    <Detail>
      <Direction>Both</Direction>
      <ValidPeriod>3</ValidPeriod>
      <Price>
        <Amount>20340</Amount>
      </Price>
      <Count>6</Count>
    </Detail>
  </Coupon>
  :
</ResultSet>
GET /v1/json/coupon/detail?key=アクセスキーを入力してください&name=新幹線回数券(自由席)
{
  "ResultSet": {
    "apiVersion": "1.27.0.0",
    "engineVersion": "202210_01a",
    "Coupon": [
      {
        "Name": "新幹線回数券(自由席):東京:新横浜",
        "Detail": {
          "Direction": "Both",
          "ValidPeriod": "3",
          "Price": {
            "Amount": "7860"
          },
          "Count": "6"
        }
      },
      {
        "Name": "新幹線回数券(自由席):東京山手線内:小田原",
        "Detail": {
          "Direction": "Both",
          "ValidPeriod": "3",
          "Price": {
            "Amount": "16800"
          },
          "Count": "6"
        }
      },
      {
        "Name": "新幹線回数券(自由席):東京都区内:熱海",
        "Detail": {
          "Direction": "Both",
          "ValidPeriod": "3",
          "Price": {
            "Amount": "20340"
          },
          "Count": "6"
        }
      },
      {
        :
      }
    ]
  }
}
ページ上部へ