Editing SimTX API/Stations (section)

== Binding a session ==
# '''Mint a ticket''' with <code>POST /api/v1/game-tickets</code>, giving <code>stationId</code> and optionally <code>antennaId</code> and <code>rigId</code>. Without <code>antennaId</code> the station's first antenna is bound; without <code>rigId</code> its first rig, or none when it has no rigs. The response's <code>station</code> object echoes what was bound and the access level. See [[SimTX API/Game tickets]].
# '''Send the hello''' with <code>auth = AUTH_KIND_GAME_TICKET</code> and the ticket.
# '''Send the start''' with <code>site.station</code> set to a [[SimTX API/Data types#StationBinding|StationBinding]]. Copy the ids from the ticket response; an empty <code>antenna_id</code> or <code>rig_id</code> selects the station's first antenna or rig, or the one the ticket was minted for.

The server checks the binding against the ticket. The start is refused with [[SimTX API/Packets/SessionStatus|SessionStatus]] <code>REJECTED</code>:
* <code>FORBIDDEN</code> when the station, antenna or rig differs from the ticket's, when a station-bound start arrives without a ticket for that station, when a ticket bound to a station is used with an ad-hoc site, or when a transmitter is started on a station the account does not own;
* <code>STATION_INACTIVE</code> when the station was deleted or the satellite has reentered.

Station tickets are issued only for servers that advertise the feature <code>stations.v1</code>; see [[SimTX API/Server directory]].