path: root/core/api-exchange.rst
diff options
authorChristian Grothoff <>2020-10-26 12:06:21 +0100
committerChristian Grothoff <>2020-10-26 12:06:21 +0100
commit8f9558c8270f85d7b9f64542e71b8f26012a7996 (patch)
treeaaeb3f20bc2d6a255b9ca8ec2e7aeac9ef301d64 /core/api-exchange.rst
parenteed5b589a172cb68810c298112505781e135975a (diff)
document status codes correctly
Diffstat (limited to 'core/api-exchange.rst')
1 files changed, 8 insertions, 4 deletions
diff --git a/core/api-exchange.rst b/core/api-exchange.rst
index af1c509..bc6a98d 100644
--- a/core/api-exchange.rst
+++ b/core/api-exchange.rst
@@ -93,12 +93,15 @@ possibly by using HTTPS.
:query last_issue_date: optional argument specifying the maximum value of any of the "stamp_start" members of the denomination keys of a "/keys" response that is already known to the client. Allows the exchange to only return keys that have changed since that timestamp. The given value must be an unsigned 64-bit integer representing seconds after 1970. If the timestamp does not exactly match the "stamp_start" of one of the denomination keys, all keys are returned.
+ :query now: request that the exchange answer the request as if the current time were the value given in "now". The given value must be an unsigned 64-bit integer representing seconds after 1970. This option is used for testing, and in production is likely not supported.
:status 200 OK:
The exchange responds with a `ExchangeKeysResponse` object. This request should
virtually always be successful.
+ :status 403 Forbidden:
+ The client specified the "now" argument, but the exchange does not allow this option as per its configuration.
@@ -528,7 +531,8 @@ exchange.
will again yield the same response, so if the network goes down during the
transaction or before the client can commit the coin signature to disk, the
coin is not lost.
- :status 401 Unauthorized: The signature is invalid.
+ :status 403 Forbidden:
+ The signature is invalid.
:status 404 Not Found:
The denomination key or the reserve are not known to the exchange. If the
denomination key is unknown, this suggests a bug in the wallet as the
@@ -857,11 +861,11 @@ the API during normal operation.
exchange. The exchange MUST return a 307 or 308 redirection to the correct
base URL if this is the case.
- :status 401 Unauthorized:
- One of the signatures is invalid.
:status 200 OK:
The request was successful. The response body is `MeltResponse` in this case.
- :status 404:
+ :status 403 Forbidden:
+ One of the signatures is invalid.
+ :status 404 Not found:
the exchange does not recognize the denomination key as belonging to the exchange,
or it has expired
:status 409 Conflict: