Editing SimTX API/Extension catalog protocol (section)

== Upload rules ==
The server validates every upload and reports the first problem found in an [[SimTX API/Packets/Error|Error]].

{| class="wikitable"
! Rule !! Limit
|-
| Kind || <code>extension</code> or <code>preset</code>
|-
| Name || 1 to 64 characters after trimming; unique per server
|-
| Description || At most 500 characters
|-
| Categories || At most 12; each 1 to 32 characters, no commas or control characters; duplicates ignored without regard to case. Categories are free text.
|-
| Files || 1 to 64 (a preset: exactly 1)
|-
| File path || At most 128 characters, relative, <code>/</code> separators only, no empty, <code>.</code> or <code>..</code> segments, unique without regard to case
|-
| File names || Extension: <code>extension.properties</code> or <code>*.lua</code>. Preset: <code>*.stxpreset</code>.
|-
| File content || Not blank; at most 60,000 bytes of UTF-8 per file
|-
| Manifest || Must be valid. See [[Lua extension manifest]]. Manifest errors are reported verbatim.
|-
| Quotas || 32 entries and 64 MiB per author; 512 MiB per server. These are server defaults and may differ.
|}

{| class="wikitable"
! Error code !! Typical messages
|-
| <code>FORBIDDEN</code> || ''Publishing requires catalog.publish'', ''An item named 'X' already exists (by Author)'', ''Only Author can remove this publication''
|-
| <code>INVALID_REQUEST</code> || ''Unknown catalog item kind 'X''', ''A preset is exactly one .stxpreset file'', ''Bad file path 'X''', manifest errors
|-
| <code>NOT_FOUND</code> || ''That item is no longer in the catalog''
|-
| <code>LIMIT_REACHED</code> || ''Catalog entry quota reached (32)'', ''Catalog storage quota reached'', ''Server catalog storage is full''
|-
| <code>UNAVAILABLE</code> || ''This server has no catalog'', ''The catalog is temporarily unavailable''
|-
| <code>INTERNAL</code> || ''Could not store the item''
|}

{{SimTX API navbox}}
[[Category:SimTX API]]
[[Category:SimTX API sessions]]