Editing SimTX API/Limits and errors (section)

== Error model ==
Every failure arrives in one of these ways:

{| class="wikitable"
! What failed !! How it arrives !! Afterwards
|-
| The hello || [[SimTX API/Packets/ServerHello|ServerHello]] with a status other than <code>ACCEPTED</code> and a message || The connection closes.
|-
| A receiver or transmitter start || [[SimTX API/Packets/SessionStatus|SessionStatus]] <code>REJECTED</code> with <code>code</code> and <code>reason</code> || The connection closes.
|-
| A running session, stopped by the server || [[SimTX API/Packets/SessionStatus|SessionStatus]] <code>ENDED</code> with <code>code</code> and <code>reason</code> || The connection closes.
|-
| A request: control, catalog, moderation, ephemeris, passes, monitor, pointing, retune || [[SimTX API/Packets/Error|Error]] with <code>code</code>, <code>message</code> and the request's <code>request_id</code> || The session continues.
|-
| A transmitter live update || [[SimTX API/Packets/TxUpdateAck|TxUpdateAck]] with <code>accepted = false</code> for the refused fields || The session continues.
|-
| A protocol violation: a malformed frame, a frame not allowed in the session, values out of range || [[SimTX API/Packets/Error|Error]] <code>INVALID_REQUEST</code>, <code>request_id</code> 0, where the server can still send it || The connection closes.
|-
| A control rate limit || [[SimTX API/Packets/Error|Error]] <code>RATE_LIMITED</code> || The connection closes.
|}

<syntaxhighlight lang="protobuf">
message Error {
  ErrorCode code = 1;
  string message = 2;
  int64 request_id = 3;
}
</syntaxhighlight>