add /config for exchange

1 files changed, 30 insertions, 1 deletions

diff --git a/core/api-exchange.rst b/core/api-exchange.rst
index 6628e8ba..9492e7e5 100644
--- a/core/api-exchange.rst
+++ b/core/api-exchange.rst
@@ -1,6 +1,6 @@
 ..
   This file is part of GNU TALER.
-  Copyright (C) 2014-2022 Taler Systems SA
+  Copyright (C) 2014-2023 Taler Systems SA
 
   TALER is free software; you can redistribute it and/or modify it under the
   terms of the GNU Affero General Public License as published by the Free Software
@@ -53,6 +53,35 @@ possibly by using HTTPS.
   returned MUST be mixed with locally generated entropy.
 
 
+.. http:get:: /config
+
+  Return the protocol version and currency supported by this exchange backend, as well as the list of possible KYC requirements.  This endpoint is largely for the SPA for AML officers. Merchants should use ``/keys`` which also contains the protocol version and currency.
+
+  **Response:**
+
+  :http:statuscode:`200 OK`:
+    The body is a `VersionResponse`.
+
+  .. ts:def:: ExchangeVersionResponse
+
+    interface ExchangeVersionResponse {
+      // libtool-style representation of the Exchange protocol version, see
+      // https://www.gnu.org/software/libtool/manual/html_node/Versioning.html#Versioning
+      // The format is "current:revision:age".
+      version: string;
+
+      // Name of the protocol.
+      name: "taler-exchange";
+
+      // Currency supported by this exchange.
+      currency: string;
+
+      // Names of supported KYC requirements.
+      supported_kyc_requirements: string[];
+
+    }
+
+
 .. http:get:: /keys
 
   Get a list of all denomination keys offered by the exchange,