Editing SimTX API (section)

== How the pieces fit ==
<syntaxhighlight lang="text">
              HTTPS + JSON                                     TLS + protobuf (v25)
  client ────────────────────────▶ auth.simtx.net      client ────────────────────────▶ game server
    1. device login         → credentials                 5. preface + ClientHello (role, ticket)
    2. GET  /api/v1/stations → your stations              6. ReceiverStart or TransmitterStart
    3. GET  /api/v1/servers  → host and port              7. IQ in, samples out, or control traffic
    4. POST /api/v1/game-tickets → one-shot ticket
</syntaxhighlight>

* '''Receiving needs no account.''' An ad-hoc receiver, which brings its own callsign, position and antenna, and the control role accept anonymous connections. Such a client skips steps 1 to 4 and needs only a host and port.
* '''Transmitting needs an account and a station.''' A transmitter is bound to one of the account's persistent [[SimTX API/Stations|stations]]. It needs the <code>game.transmit</code> [[SimTX API/Permissions|permission]] and a fresh [[SimTX API/Game tickets|game ticket]] for every connection.
* '''Station-bound reception''' works on the account's own stations and on any PUBLIC station of another account, including [[SimTX API/Satellites|satellites]].
* '''One TCP connection is one session.''' A client that wants two receivers, or a receiver and a transmitter, opens two connections.