commit 3731a08d825f061d7f6d260f9df0d69494b0ccd7
parent 18ca61584720e78f5f3b7eb73e593fecc174dd92
Author: Christian Grothoff <christian@grothoff.org>
Date: Thu, 30 Jul 2026 11:19:38 +0200
spec for #11693: introduce max_age_s
Diffstat:
2 files changed, 5 insertions(+), 2 deletions(-)
diff --git a/core/api-merchant.rst b/core/api-merchant.rst
@@ -59,7 +59,9 @@ The currently implemented protocol version is **v33**.
* ``v30``: adds ``debit_restrictions`` to GET /exchanges (for SPA)
* ``v31``: adds ``/private/accept-tos-early`` and related API changes
* ``v32``: adds "force" argument for locked product deletion
-* ``v33``: adds ``build_version`` to :http:get:`/config </config>`
+* ``v33``: adds ``build_version`` to :http:get:`/config </config>` and
+ ``max_age_s`` to ``[/instances/$INSTANCE]/private/orders``, deprecating
+ the ``max_age`` query parameter of that endpoint
**Upcoming versions:**
diff --git a/core/merchant/get-private-orders.rst b/core/merchant/get-private-orders.rst
@@ -17,7 +17,8 @@
:query delta: *Optional*. takes value of the form ``N (-N)``, so that at most ``N`` values strictly older (younger) than ``start`` and ``date_s`` are returned. Defaults to ``-20`` to return the last 20 entries (before ``start`` and/or ``date_s``). Deprecated in protocol **v12**. Use *limit* instead.
:query limit: *Optional*. At most return the given number of results. Negative for descending by row ID, positive for ascending by row ID. Default is ``20``. Since protocol **v12**.
:query date_s: *Optional.* Non-negative date in seconds after the UNIX Epoc. Only return orders created after the specified timestamp.
- :query max_age: *Optional.* Relative time. Only return orders younger than the specified age. Only applicable if *delta* is positive. If both *max_age* and *date_s* are given, the larger of the two applies. Since protocol **v27**.
+ :query max_age: *Optional.* Relative time in milliseconds. Only return orders younger than the specified age. Only applicable if *delta* is positive. If both *max_age* and *date_s* are given, the larger of the two applies. Since protocol **v27**. Deprecated in protocol **v33**. Use *max_age_s* instead.
+ :query max_age_s: *Optional.* Relative time in seconds. Only return orders younger than the specified age. Only applicable if *limit* is positive. If both *max_age_s* and *date_s* are given, the larger of the two applies. If both *max_age_s* and the deprecated *max_age* are given, *max_age_s* applies. Since protocol **v33**.
:query start: *Optional*. Row number threshold, see ``limit`` for its interpretation. Defaults to ``INT64_MAX``, namely the biggest row id possible in the database. Deprecated in protocol **v12**. Use *offset* instead.
:query offset: *Optional*. Starting ``row_id`` for an iteration. Since protocol **v12**.
:query timeout_ms: *Optional*. Timeout in milliseconds to wait for additional orders if the answer would otherwise be negative (long polling). Only useful if ``limit`` is positive. Note that the merchant MAY still return a response that contains fewer than ``limit`` orders.
