| | @@ -0,0 +1,52 @@ |
| 1 | +# JSON API: /settings
|
| 2 | +([⬑JSON API Index](index.md))
|
| 3 | +
|
| 4 | +Jump to:
|
| 5 | +
|
| 6 | +* [Fetch Settings](#get)
|
| 7 | +* Set Settings is TODOget)
|
| 8 | +* [Set Settings](#set)
|
| 9 | +
|
| 10 | +---
|
| 11 | +
|
| 12 | +<a id="get"></a>
|
| 13 | +# Fetch Settings
|
| 14 | +
|
| 15 | +**Status:** Implemented 20230120
|
| 16 | +
|
| 17 | +**Required permissions:** "o"
|
| 18 | +
|
| 19 | +**Request:** `/json/settings/get[?version=X]`
|
| 20 | +
|
| 21 | +**Response payload example:**
|
| 22 | +
|
| 23 | +```json
|
| 24 | +{
|
| 25 | + "access-log":{
|
| 26 | + "versionable":false,
|
| 27 | + "sensitive":false,
|
| 28 | + "defaultValue":"off",
|
| 29 | + "valueSource":null,
|
| 30 | + "value":null
|
| 31 | + },
|
| 32 | +...
|
| 33 | + "binary-glob":{
|
| 34 | + "versionable":true,
|
| 35 | + "sensitive":false,
|
| 36 | + "defaultValue":null,
|
| 37 | + "valueSource":"versioned",
|
| 38 | + "value":"*.gif\n*.ico\n*.jpg\n*.odp\n*.dia\n*.pdf\n*.png\n*.wav..."
|
| 39 | + },
|
| 40 | +...
|
| 41 | + "web-browser":{
|
| 42 | + "versionable":false,
|
| 43 | + "sensitive":true,
|
| 44 | + "defaultValue":null,
|
| 45 | + "valueSource":"repo",
|
| 46 | + "value":"firefox"
|
| 47 | + }
|
| 48 | +}
|
| 49 | +```
|
| 50 | +
|
| 51 | +Each key in the payload is the name of a fossil-recognized setting,
|
| 52 | +modeled as an object. Th |