taler-docs

commit 0c6fc42f54afe8c13fdbdb5228b76d8af8773746
parent 42227202ed7a660187ca3990a75bf54cf4f94503
Author: Martin Schanzenbach <schanzen@gnunet.org>
Date:   Tue, 27 Oct 2026 10:48:34 +0100

taldir: Fix API and include valid for durations of directory entries

Diffstat:
M
core/taldir/get-H_ALIAS.rst
 | 
8
+++++---
M
core/taldir/post-H_ALIAS.rst
 | 
8
+++++---

2 files changed, 10 insertions(+), 6 deletions(-)
diff --git a/core/taldir/get-H_ALIAS.rst b/core/taldir/get-H_ALIAS.rst
@@ -11,17 +11,19 @@
   registration is still expected to be valid.
 
   :http:statuscode:`200 Ok`:
-     Registration information returned, of type `MailboxDetailResponse`
+     Registration information returned, of type `DirectoryEntryResponse`
   :http:statuscode:`404 Not found`:
      The alias is unknown (original registration may have expired).
 
   .. _MailboxDetailResponse:
-  .. ts:def:: MailboxDetailResponse
+  .. ts:def:: DirectoryEntryResponse
 
-    interface MailboxDetailResponse {
+    interface DirectoryEntryResponse {
 
       // Target URI to associate with this alias.
       target_uri: string;
 
+      // The remaining duration for which this registration is still paid for
+      valid_for?: RelativeTime;
 
     }
diff --git a/core/taldir/post-H_ALIAS.rst b/core/taldir/post-H_ALIAS.rst
@@ -21,9 +21,11 @@
 
   **Response**
 
-  :http:statuscode:`204 No Content`:
-     Registration complete.
-  :http:statuscode:`403 Forbidden`:
+  :http:statuscode:`200 Ok`
+     Registration already exists for this alias for the specified duration.
+     Returns for how long this registration is paid for.
+     The response format is given by `AlreadyPaidResponse`_.
+   :http:statuscode:`403 Forbidden`:
      The ``solution`` is invalid. Retrying immediately is allowed.
   :http:statuscode:`404 Not found`:
      The alias is unknown (original registration attempt may have expired).