← Back to team overview

dhis2-devs team mailing list archive

[Branch ~dhis2-documenters/dhis2/dhis2-docbook-docs] Rev 805: Docs web api system settings

 

------------------------------------------------------------
revno: 805
committer: Lars Helge Øverland <larshelge@xxxxxxxxx>
branch nick: dhis2-docbook-docs
timestamp: Fri 2013-09-20 12:41:23 +0200
message:
  Docs web api system settings
modified:
  src/docbkx/en/dhis2_user_man_web_api.xml


--
lp:~dhis2-documenters/dhis2/dhis2-docbook-docs
https://code.launchpad.net/~dhis2-documenters/dhis2/dhis2-docbook-docs

Your team DHIS 2 developers is subscribed to branch lp:~dhis2-documenters/dhis2/dhis2-docbook-docs.
To unsubscribe from this branch go to https://code.launchpad.net/~dhis2-documenters/dhis2/dhis2-docbook-docs/+edit-subscription
=== modified file 'src/docbkx/en/dhis2_user_man_web_api.xml'
--- src/docbkx/en/dhis2_user_man_web_api.xml	2013-09-18 20:49:23 +0000
+++ src/docbkx/en/dhis2_user_man_web_api.xml	2013-09-20 10:41:23 +0000
@@ -2427,6 +2427,20 @@
       assigned organisation units, you can use the query parameter <emphasis role="italic">includeDescendants=true</emphasis>.</para>
   </section>
   <section>
+    <title>System settings</title>
+    <para>You can manipulate system settings by interacting with the <emphasis role="italic"
+        >systemSettings</emphasis> resource. A system setting is a simple key-value pair, where both
+      the key and the value are plain text strings. To save or update a system setting you can make
+      a <emphasis role="italic">POST</emphasis> request to the following URL:</para>
+    <screen>/api/systemSettings/my-key?my-value</screen>
+    <para>You should replace my-key with your real key and my-value with your real value. To
+      retrieve the value for a given key in plain text you can make a <emphasis role="italic"
+        >GET</emphasis> request to the following URL:</para>
+    <screen>/api/systemSettings/my-key</screen>
+    <para>To delete a system setting, you can make a <emphasis role="italic">DELETE</emphasis>
+      request to the URL similar to the one used above for retrieval.</para>
+  </section>
+  <section>
     <title>FRED API</title>
     <para>DHIS 2 from version 2.11 implements support for the current draft
       of the FRED API version 1.0. The project defines itself as <quote>open standard for sharing and updating