dhis2-devs team mailing list archive
-
dhis2-devs team
-
Mailing list archive
-
Message #30506
[Branch ~dhis2-documenters/dhis2/dhis2-docbook-docs] Rev 1091: Message json docs
------------------------------------------------------------
revno: 1091
committer: Lars Helge Overland <larshelge@xxxxxxxxx>
branch nick: dhis2-docbook-docs
timestamp: Fri 2014-05-30 20:54:42 +0200
message:
Message json docs
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 2014-05-30 18:30:37 +0000
+++ src/docbkx/en/dhis2_user_man_web_api.xml 2014-05-30 18:54:42 +0000
@@ -1620,6 +1620,31 @@
</message></screen>
<para>To test this we save the XML content into a file called <emphasis role="italic">message.xml</emphasis>. We use cURL to dispatch the message the the DHIS 2 demo instance where we indicate that the content-type is XML and authenticate as the <emphasis role="italic">admin</emphasis> user:</para>
<screen>curl -d @message.xml "http://apps.dhis2.org/demo/api/messageConversations" -H "Content-Type:application/xml" -u admin:district -X POST -v</screen>
+ <para>A corresponding payload in JSON and POST command look like this:</para>
+ <screen>{
+ "subject": "Hey",
+ "text": "How are you?",
+ "users": [
+ {
+ "id": "OYLGMiazHtW"
+ },
+ {
+ "id": "N3PZBUlN8vq"
+ }
+ ],
+ "userGroups": [
+ {
+ "id": "ZoHNWQajIoe"
+ }
+ ],
+ "organisationUnits": [
+ {
+ "id": "DiszpKrYNg8"
+ }
+ ]
+}
+</screen>
+ <screen>curl -d @message.json "http://apps.dhis2.org/demo/api/messageConversations" -H "Content-Type:application/json" -u admin:district -X POST -v</screen>
<para>If all is well we receive a <emphasis role="italic">201 Created</emphasis> HTTP status code. Also note that we receive a <emphasis role="italic">Location </emphasis>HTTP header which value informs us of the URL of the newly created message conversation resource - this can be used by a consumer to perform further action.</para>
<para>We will now pretend to be the mobile user and read the message which was just sent by dispatching a GET request to the <emphasis role="italic">messageConversations</emphasis> resource. We supply an <emphasis role="italic">Accept</emphasis> header with <emphasis role="italic">application/xml</emphasis> as the value to indicate that we are interested in the XML resource representation and we authenticate as the <emphasis role="italic">mobile</emphasis> user:</para>
<screen>curl "http://apps.dhis2.org/demo/api/messageConversations" -H "Accept:application/xml" -u mobile:district -X GET -v</screen>