Editing SimTX API/Satellites (section)

== Satellites on the wire ==
* The [[SimTX API/Packets/StationList|station list]] contains every ACTIVE or DEORBITING PUBLIC satellite, with or without sessions. <code>core.location</code> is the sub-satellite point at <code>captured_at_ms</code>, and <code>core.orbit</code> and <code>core.attitude</code> describe its motion. <code>LiveSession.location</code> of a session on the satellite moves with it.
* A session bound to a satellite gets the elements in <code>SessionStatus.station.core.orbit</code>, and <code>UPDATED</code> statuses when they change or when the deorbit burn fires. See [[SimTX API/Session status#Satellites|Session status]].
* [[SimTX API/Packets/EphemerisRequest|EphemerisRequest]] returns positions over a time window, and [[SimTX API/Packets/PassPredictionRequest|PassPredictionRequest]] returns passes over an observer. Both are control requests and need the server features <code>ephemeris</code> and <code>passes</code>.
* The account service lists PUBLIC satellites without authentication at <code>GET /api/v1/satellites</code>. See [[SimTX API/Public endpoints#Public satellites|Public endpoints]].

Clients may propagate the elements locally to draw satellites, using the model below, or ask the server. '''The server is authoritative.''' Use the server's simulation clock (<code>ServerHello.simulation_time_ms</code>, or a recent <code>StationList.captured_at_ms</code>) as "now", not the local clock.