commit 4dc726bbeb8611857696794171c5c4f088a48849 parent c49d12e22c23bbee4eaa87e842621c90223219d5 Author: Christian Grothoff <christian@grothoff.org> Date: Fri, 26 Sep 2025 15:36:17 +0200 fix #10456 Diffstat:
| M | core/api-donau.rst | | | 17 | +++++++++++++---- |
1 file changed, 13 insertions(+), 4 deletions(-)
diff --git a/core/api-donau.rst b/core/api-donau.rst @@ -605,14 +605,23 @@ The GET status requests require an authorized bearer token as well. .. _donau_charity_get: -.. http:get:: /charities/$CHARITY_ID +.. http:get:: /charity/$CHARITY_ID - GET a specific charity. Only allowed if the request comes with the charity or administration bearer token. - - Request information about a charity. + Request information about a specific charity. + Only allowed if the request comes with a signature by + the respective charity. **Request:** + *Charity-Signature*: + + The client must provide Base-32 encoded EdDSA signature with + ``$CHARITY_PRIV``, affirming the desire to obtain the charity status. + Note that this is merely a simple authentication mechanism, + the details of the request are not protected by the signature. + The ``$CHARITY_PRIV`` is usually the merchant instance + private key. + **Response:** :http:statuscode:`200 OK`: