View Issue Details

IDProjectCategoryView StatusLast Update
0009388Talerdocumentationpublic2026-02-27 22:24
Reporteroec Assigned ToChristian Grothoff  
PrioritynormalSeveritytextReproducibilityhave not tried
Status resolvedResolutionfixed 
Product Versiongit (master) 
Target Version1.5Fixed in Version1.5 
Summary0009388: Add semver information to REST-API endpoints
DescriptionRight now, docs.taler.net does not contain API version information per REST-API endpoint.
Soon we will have a situation where some API's are only available in some version (ranges).

We should add the open and closed ranges of the semver Version per API-Endpoint to the documentation
of the REST-API documentation of (at least) exchange and merchant.

Note that this also means that we _might_ need to add semver information to particular data structures, interfaces and their members.
TagsNo tags attached.

Relationships

related to 0009441 resolvedChristian Grothoff Protocol version missing in public documentation 

Activities

Christian Grothoff

2026-02-27 22:24

manager   ~0027933

5875b7ec..63b675a7 adds version documentation to each of the APIs. Note that we do NOT use semver, we use libtool-style versioning for protocols (with ranges). So to see the range, you need to look at "@since" and possibly "@deprecated" annotations to see which range of protocols a particular field or endpoint is supported for.

Issue History

Date Modified Username Field Change
2024-12-16 12:24 oec New Issue
2024-12-16 12:24 oec Status new => assigned
2024-12-16 12:24 oec Assigned To => Stefan
2024-12-16 12:28 oec Description Updated
2024-12-16 12:28 oec Assigned To Stefan => oec
2024-12-16 15:32 oec Target Version post-1.0 => 1.0 stretch goals
2025-04-17 22:23 Christian Grothoff Target Version 1.0 stretch goals => post-1.0
2025-05-08 22:45 Christian Grothoff Assigned To oec =>
2025-05-08 22:45 Christian Grothoff Severity feature => text
2025-05-08 22:45 Christian Grothoff Status assigned => confirmed
2026-02-07 22:45 Christian Grothoff Relationship added related to 0009441
2026-02-07 22:45 Christian Grothoff Assigned To => Christian Grothoff
2026-02-07 22:45 Christian Grothoff Status confirmed => assigned
2026-02-07 22:45 Christian Grothoff Status assigned => confirmed
2026-02-27 22:24 Christian Grothoff Note Added: 0027933
2026-02-27 22:24 Christian Grothoff Status confirmed => resolved
2026-02-27 22:24 Christian Grothoff Resolution open => fixed
2026-02-27 22:24 Christian Grothoff Fixed in Version => 1.5
2026-02-27 22:24 Christian Grothoff Target Version post-1.0 => 1.5