SimTX API/Packets/CatalogUploadResult: Difference between revisions

Latest revision as of 17:16, 24 October 2026

API overviewQuick startHandshakeFramingAll messagesData typesStationsAccount serviceLimits and errorsv24 reference

CatalogUploadResult
Frame	`ServerFrame`, field 38
Member	`catalog_upload_result`
Direction	Server → client
Session	Control (catalog)
Roles	`ROLE_CONTROL`.
Permission	None
Answered by
Answers	CatalogUpload
Defined in	`control.proto`

CatalogUploadResult confirms a successful CatalogUpload. A refused upload is answered with Error instead.

Definition[edit | edit source]

message CatalogUploadResult {
  reserved 2, 3;
  int64 request_id = 1;
  int32 entry_id = 4;
  bool updated = 5;            // true: replaced your existing publication of that name
}

Fields[edit | edit source]

#	Field	Type	Description
1	`request_id`	`int64`	The request this answers.
4	`entry_id`	`int32`	ID of the published entry.
5	`updated`	`bool`	True: the upload replaced your existing entry of that name and its revision increased.

Field numbers 2 and 3 are reserved; do not use them.

Example[edit | edit source]

Complete frames, including the varint length prefix.

catalog_upload_result_updated (server to client, 10 bytes):

09        frame length 9
B2 02 06  catalog_upload_result (CatalogUploadResult), 6 bytes
  08 2B   request_id = 43
  20 11   entry_id = 17
  28 01   updated = true

See also[edit | edit source]

CatalogUpload

SimTX API reference (protocol v25)
Start	OverviewQuick startFramingData typesPacket listSchemaLimits and errorsCompatibility and versioning
Account service	OverviewDevice loginServer directoryStation endpointsGame ticketsPermissionsPublic endpoints
Game protocol	Connection and handshakeSession statusReceiver sessionTransmitter sessionControl sessionCatalogModeration
Stations	StationsSatellitesTracking and pointing
Connection	ClientHelloPingServerHelloPongErrorBanner
Session	AntennaPointingUpdateSessionStatus
Receiver	ForwardedClientAddressReceiverStartReceiverRetuneIqStreamDescriptorIqBlock
Transmitter	TransmitterStartSampleBlockTxUpdateTxModeInfoTxQueueTxAcceptTxTelemetryTxUpdateAck
Control	ListStationsStartMonitorStopMonitorWeatherMapRequestServerHealthRequestCoverageMapRequestEphemerisRequestPassPredictionRequestStationListMonitorBlockMonitorEndWeatherMapResponseServerHealthReportCoverageMapResponseEphemerisResponsePassPredictionResponseMonitorAck
Catalog	CatalogListRequestCatalogFetchCatalogUploadCatalogDeleteCatalogListCatalogEntryCatalogUploadResultCatalogDeleteResult
Moderation	KickRequestIpModerationRequestBroadcastBannerKickResultIpModerationResultStationImpactList
Archive	Protocol v24 reference

@@ Line 1: / Line 1: @@
-#REDIRECT [[SimTX API v24/Packets/CatalogUploadResult]]
+{{SimTX API navigation}}
+{{SimTX packet
+| name = CatalogUploadResult
+| frame = ServerFrame
+| field = 38
+| member = catalog_upload_result
+| direction = s2c
+| session = [[SimTX API/Extension catalog protocol|Control (catalog)]]
+| roles = <code>ROLE_CONTROL</code>.
+| permission = None
+| answers = [[SimTX API/Packets/CatalogUpload|CatalogUpload]]
+| group = catalog
+| file = control.proto
+}}
+'''CatalogUploadResult''' confirms a successful [[SimTX API/Packets/CatalogUpload|CatalogUpload]]. A refused upload is answered with [[SimTX API/Packets/Error|Error]] instead.
+== Definition ==
+<syntaxhighlight lang="protobuf">
+message CatalogUploadResult {
+  reserved 2, 3;
+  int64 request_id = 1;
+  int32 entry_id = 4;
+  bool updated = 5;            // true: replaced your existing publication of that name
+}
+</syntaxhighlight>
+== Fields ==
+{| class="wikitable"
+! # !! Field !! Type !! Description
+|-
+| 1 || <code>request_id</code> || <code>int64</code> || The request this answers.
+|-
+| 4 || <code>entry_id</code> || <code>int32</code> || ID of the published entry.
+|-
+| 5 || <code>updated</code> || <code>bool</code> || True: the upload replaced your existing entry of that name and its revision increased.
+|}
+Field numbers 2 and 3 are reserved; do not use them.
+== Example ==
+Complete frames, including the varint length prefix.
+'''<code>catalog_upload_result_updated</code>''' (server to client, 10 bytes):
+<syntaxhighlight lang="text">
+        frame length 9
+B2 02 06  catalog_upload_result (CatalogUploadResult), 6 bytes
+2B   request_id = 43
+11   entry_id = 17
+01   updated = true
+</syntaxhighlight>
+== See also ==
+* [[SimTX API/Packets/CatalogUpload|CatalogUpload]]
+{{SimTX API navbox}}
+[[Category:SimTX API]]