path: root/core
diff options
authorChristian Grothoff <>2019-12-02 21:55:17 +0100
committerChristian Grothoff <>2019-12-02 21:55:28 +0100
commite77ad2d80d240ba1cc8fb286fe8a7af56b881ee9 (patch)
treee515977115e36abf9acaf39a7d12843bb18d8c65 /core
parent77c00cf9f710c0cff1836782a7b16113e01b6d42 (diff)
document /terms endpoint
Diffstat (limited to 'core')
1 files changed, 16 insertions, 0 deletions
diff --git a/core/api-exchange.rst b/core/api-exchange.rst
index 66ec92a..13c35d5 100644
--- a/core/api-exchange.rst
+++ b/core/api-exchange.rst
@@ -41,6 +41,22 @@ hard-coded into the wallet as they are the trust anchors for Taler; (3)
possibly by using HTTPS.
+.. http:get:: /terms
+ Get the terms of service 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 terms of service have changed. If not, a
+ "204 Not Modified" response will be returned.
.. http:get:: /keys
Get a list of all denomination keys offered by the bank,