[taler-docs] branch master updated: document /privacy, and missing Etag case

[gnunet]

This is an automated email from the git hooks/post-receive script.

grothoff pushed a commit to branch master
in repository docs.

The following commit(s) were added to refs/heads/master by this push:
     new e3a6f4f  document /privacy, and missing Etag case
e3a6f4f is described below

commit e3a6f4fde54052f9b4e6f959fe5e94cbc96ffe51
Author: Christian Grothoff <address@hidden>
AuthorDate: Wed Dec 11 14:34:09 2019 +0100

    document /privacy, and missing Etag case
---
 core/api-exchange.rst | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/core/api-exchange.rst b/core/api-exchange.rst
index 13c35d5..5fa7fe7 100644
--- a/core/api-exchange.rst
+++ b/core/api-exchange.rst
@@ -56,6 +56,25 @@ possibly by using HTTPS.
   to detect if the terms of service have changed.  If not, a
   "204 Not Modified" response will be returned.
 
+  If the "Etag" is missing, the client should not cache the response and 
instead prompt the user again at the next opportunity. This is usually only the 
case if the terms of service were not configured correctly.
+
+
+  .. http:get:: /privacy
+
+  Get the privacy policy of the exchange.
+  The exchange will consider the "Accept" and "Accept-Language" and
+  "Accept-Encoding" headers when generating a response. Specifically,
+  it will try to find a response with an acceptable mime-type, then
+  pick the version in the most preferred language of the user, and
+  finally apply compression if that is allowed by the client and
+  deemed beneficial.
+
+  The exchange will set an "Etag", and subsequent requests of the
+  same client should provide the tag in an "If-None-Match" header
+  to detect if the privacy policy has changed.  If not, a
+  "204 Not Modified" response will be returned.
+
+  If the "Etag" is missing, the client should not cache the response and 
instead prompt the user again at the next opportunity. This is usually only the 
case if the privacy policy was not configured correctly.
 
 .. http:get:: /keys
 

-- 
To stop receiving notification emails like this one, please contact
address@hidden.