[taler-docs] 01/02: document 308 redirect for deprecated /instances/default/* URLs

[gnunet]

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

grothoff pushed a commit to branch master
in repository docs.

commit cdcbf16507936e91b5649957ecaaf27032c501f6
Author: Christian Grothoff <christian@grothoff.org>
AuthorDate: Mon Feb 5 22:22:29 2024 +0100

    document 308 redirect for deprecated /instances/default/* URLs
---
 core/api-merchant.rst | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/core/api-merchant.rst b/core/api-merchant.rst
index 3582e628..652c7303 100644
--- a/core/api-merchant.rst
+++ b/core/api-merchant.rst
@@ -36,11 +36,13 @@ This is useful when multiple businesses want to share the 
same payment
 infrastructure.
 
 Merchant backends have one special ``default`` instance.  This ``default``
-instance is used when no explicit instance is specified.  Despite its name,
-this instance must be created after the installation.  In case *no* default
-instance is found - or its credentials got lost -, the administrator can use
-the default instance's rights by resorting on the ``--auth`` command line 
option,
-or by restarting the service by providing an environment variable called
+instance is used when no explicit instance is specified.  Note that using
+``/instances/default/$ANYTHING`` is deprecated and will result in a permanent
+redirect (HTTP status 308) to ``$ANYTHING``. a Despite its name, this instance
+must be created after the installation.  In case *no* default instance is
+found - or its credentials got lost -, the administrator can use the default
+instance's rights by resorting on the ``--auth`` command line option, or by
+restarting the service by providing an environment variable called
 ``TALER_MERCHANT_TOKEN``.
 
 Each instance (default and others) has a base URL.  The resources under
@@ -74,10 +76,10 @@ Examples:
    https://merchant-backend.example.com/instances/myinst/orders/ABCD
 
    A private endpoint (explicit "default" instance):
-   https://merchant-backend.example.com/instances/default/private/orders
+   https://merchant-backend.example.com/private/orders
 
    A public endpoint (explicit "default" instance):
-   https://merchant-backend.example.com/instances/default/orders
+   https://merchant-backend.example.com/orders
 
    Endpoints to manage other instances (ONLY for implicit "default" instance):
    https://merchant-backend.example.com/management/instances

-- 
To stop receiving notification emails like this one, please contact
gnunet@gnunet.org.