<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<application xmlns="http://wadl.dev.java.net/2009/02" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://wadl.dev.java.net/2009/02 wadl.xsd">
  <resources base="https://cdt.hafas.de/opendata/apiserver/">
    <resource path="departureBoard">
      <method name="GET">
        <request>
          <param name="accessId" required="true" style="query" type="xsd:string">
            <doc title="description"><![CDATA[Access ID for identifying the requesting client. String not longer than 128.]]></doc>
            <doc title="since"><![CDATA[1.0]]></doc>
          </param>
          <param name="aid" required="false" style="query" type="xsd:string">
            <doc title="description"><![CDATA[Access ID that overrides the security value from the configuration. String not longer than 64.]]></doc>
            <doc title="since"><![CDATA[2.40]]></doc>
          </param>
          <param name="requestId" required="false" style="query" type="xsd:string">
            <doc title="description"><![CDATA[Request ID for identifying the request. String not longer than 2048.]]></doc>
          </param>
          <param name="format" required="false" style="query" type="xsd:string">
            <option value="xml"/>
            <option value="json"/>
            <doc title="description"><![CDATA[Requested response format. If not set, the Accept-Header is used. If both are missing application/xml is used]]></doc>
          </param>
          <param default="de" name="lang" required="false" style="query" type="xsd:string">
            <doc title="description"><![CDATA[The language of the journey planer. String not longer than 25.]]></doc>
          </param>
          <param name="id" required="false" style="query" type="xsd:string">
            <doc title="description"><![CDATA[Specifies the station/stop ID for which the departures shall be retrieved. Required if extId is not present. String not longer than 512.]]></doc>
            <doc title="since"><![CDATA[1.0]]></doc>
          </param>
          <param name="extId" required="false" style="query" type="xsd:string">
            <doc title="deprecated"><![CDATA[Deprecated. Please use `id` as it supports external IDs.]]></doc>
            <doc title="description"><![CDATA[Specifies the external station/stop ID for which the departures shall be retrieved. Required if id is not present. String not longer than 512.]]></doc>
            <doc title="since"><![CDATA[1.21]]></doc>
          </param>
          <param name="direction" required="false" style="query" type="xsd:string">
            <doc title="description"><![CDATA[If only vehicles departing or arriving from a certain direction shall be returned, specify the direction by giving the station/stop ID of the last stop on the journey. String not longer than 512.]]></doc>
            <doc title="since"><![CDATA[1.0]]></doc>
          </param>
          <param name="date" required="false" style="query" type="xsd:string">
            <doc title="description"><![CDATA[Sets the start date for which the departures shall be retrieved. Represented in the format YYYY-MM-DD.]]></doc>
            <doc title="since"><![CDATA[1.0]]></doc>
          </param>
          <param name="time" required="false" style="query" type="xsd:string">
            <doc title="description"><![CDATA[Sets the start time for which the departures shall be retrieved. Represented in the format hh:mm[:ss] in 24h nomenclature. Seconds will be ignored for requests.]]></doc>
            <doc title="since"><![CDATA[1.0]]></doc>
          </param>
          <param name="dur" required="false" style="query" type="xsd:int"/>
          <param default="60" name="duration" required="false" style="query" type="xsd:int">
            <doc title="description"><![CDATA[Set the interval size in minutes. Range: 0-1439]]></doc>
            <doc title="since"><![CDATA[1.0]]></doc>
          </param>
          <param default="-1" name="maxJourneys" required="false" style="query" type="xsd:int">
            <doc title="description"><![CDATA[Maximum number of journeys to be returned. If no value is defined or -1, all departing/arriving services within the duration sized period are returned. Minimum of -1.]]></doc>
            <doc title="since"><![CDATA[1.0]]></doc>
          </param>
          <param name="products" required="false" style="query" type="xsd:int">
            <doc title="description"><![CDATA[Decimal value defining the product classes to be included in the search. It represents a bitmask combining bit number of a product as defined in the HAFAS raw data. Values are retrievable by <<service_datainfo,Data Information service>>. Minimum of 0.]]></doc>
            <doc title="since"><![CDATA[1.12]]></doc>
          </param>
          <param name="operators" required="false" style="query" type="xsd:string">
            <doc title="description"><![CDATA[Only journeys provided by the given operators are part of the result. To filter multiple operators, separate the codes by comma.
If the operator should not be part of the journeys, negate it by putting ! in front of it. String not longer than 1024.]]></doc>
            <doc title="since"><![CDATA[1.0]]></doc>
          </param>
          <param name="categories" required="false" style="query" type="xsd:string">
            <doc title="description"><![CDATA[Only journeys provided by the given categories are part of the result. To filter multiple categories, separate the codes by comma.
If the category should not be part of the journeys, negate it by putting ! in front of it. String not longer than 1024.]]></doc>
            <doc title="since"><![CDATA[2.25]]></doc>
          </param>
          <param name="lines" required="false" style="query" type="xsd:string">
            <doc title="description"><![CDATA[Only journeys running the given line are part of the result. To filter multiple lines, separate the codes by comma. If the line should not be part of the be trip, negate it by putting ! in front of it. String not longer than 1024.]]></doc>
            <doc title="since"><![CDATA[1.0]]></doc>
          </param>
          <param name="globallineids" required="false" style="query" type="xsd:string">
            <doc title="description"><![CDATA[Only journeys running the given line (identified by its global line ID) are part of the result. To filter multiple lines, separate the global line IDs by comma. If the line should not be part of the trip, negate it by putting ! in front of it. String not longer than 1024.]]></doc>
            <doc title="since"><![CDATA[2.50]]></doc>
          </param>
          <param name="attributes" required="false" style="query" type="xsd:string">
            <doc title="description"><![CDATA[Filter boards by one or more attribute codes of a journey. Multiple attribute codes are separated by comma. If the attribute should not be part of the result, negate it by putting ! in front of it. String not longer than 1024.]]></doc>
            <doc title="since"><![CDATA[1.0]]></doc>
          </param>
          <param name="platforms" required="false" style="query" type="xsd:string">
            <doc title="description"><![CDATA[Filter boards by platform. Multiple platforms are separated by comma. String not longer than 1024.]]></doc>
            <doc title="since"><![CDATA[2.7.2]]></doc>
          </param>
          <param default="false" name="passlist" required="false" style="query" type="xsd:int">
            <doc title="description"><![CDATA[Include a list of all passed waystops?]]></doc>
            <doc title="since"><![CDATA[1.0]]></doc>
          </param>
          <param name="passlistMaxStops" required="false" style="query" type="xsd:int">
            <doc title="description"><![CDATA[Maximum number of stops including requested stop and last stop. Minimum of 0.]]></doc>
            <doc title="since"><![CDATA[1.0]]></doc>
          </param>
          <param name="minDur" required="false" style="query" type="xsd:int">
            <doc title="description"><![CDATA[Minimum duration a journey has left to be returned. Minimum of 0.]]></doc>
            <doc title="since"><![CDATA[1.0]]></doc>
          </param>
          <param default="false" name="baim" required="false" style="query" type="xsd:int">
            <doc title="description"><![CDATA[Enables/disables BAIM information.]]></doc>
            <doc title="since"><![CDATA[2.26]]></doc>
          </param>
          <param default="SERVER_DEFAULT" name="rtMode" required="false" style="query" type="xsd:string">
            <option value="OFF"/>
            <option value="SERVER_DEFAULT"/>
            <doc title="description"><![CDATA[Set the realtime mode to be used.]]></doc>
            <doc title="since"><![CDATA[2.34]]></doc>
          </param>
          <param default="DEP" name="type" required="true" style="query" type="xsd:string">
            <option value="DEP"/>
            <option value="DEP_EQUIVS"/>
            <option value="DEP_MAST"/>
            <option value="DEP_STATION"/>
            <doc title="description"><![CDATA[Set the station departure board type to be used.

DEP: Departure board as configured in HAFAS
DEP_EQUIVS: Departure board with all journeys at any masts and equivalent stops
DEP_MAST: Departure board at mast
DEP_STATION: Departure board with all journeys at any masts of the requested station]]></doc>
            <doc title="since"><![CDATA[2.12]]></doc>
          </param>
        </request>
        <response>
          <representation xmlns:proxy="http://hacon.de/hafas/proxy/hafas-proxy" element="proxy:DepartureBoard"/>
        </response>
      </method>
    </resource>
  </resources>
</application>
