View Issue Details

IDProjectCategoryView StatusLast Update
0009388Talerdocumentationpublic2026-03-20 23:55
Reporteroec Assigned ToChristian Grothoff Resolution deadline
ImplementerReviewer 
Release signed byDeployed by 
VerifierCommunicator 
Data protection authority notification requiredNo  
CSIRT notification requiredNo  
Estimated effort (hours)Actual effort (hours)0 
Fast-trackNo
Work packagenone
PrioritynormalSeveritytextReproducibilityhave not tried
Status closedResolutionfixed 
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.

Required notifications

Address or linkRemarkAdded byNotifiedActions

Relationships

related to 0009441 closedChristian Grothoff Protocol version missing in public documentation 

Activities

Christian Grothoff

2026-02-27 21: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 ModifiedUsernameFieldChange
2024-12-16 11:24oecNew Issue
2024-12-16 11:24oecStatusnew => assigned
2024-12-16 11:24oecAssigned To => Stefan
2024-12-16 11:28oecDescription Updated
2024-12-16 11:28oecAssigned ToStefan => oec
2024-12-16 14:32oecTarget Versionpost-1.0 => 1.0 stretch goals
2025-04-17 20:23Christian GrothoffTarget Version1.0 stretch goals => post-1.0
2025-05-08 20:45Christian GrothoffAssigned Tooec =>
2025-05-08 20:45Christian GrothoffSeverityfeature => text
2025-05-08 20:45Christian GrothoffStatusassigned => implementing
2026-02-07 21:45Christian GrothoffRelationship addedrelated to 0009441
2026-02-07 21:45Christian GrothoffAssigned To => Christian Grothoff
2026-02-07 21:45Christian GrothoffStatusimplementing => assigned
2026-02-07 21:45Christian GrothoffStatusassigned => implementing
2026-02-27 21:24Christian GrothoffNote Added: 0027933
2026-02-27 21:24Christian GrothoffStatusimplementing => informing
2026-02-27 21:24Christian GrothoffResolutionopen => fixed
2026-02-27 21:24Christian GrothoffFixed in Version => 1.5
2026-02-27 21:24Christian GrothoffTarget Versionpost-1.0 => 1.5
2026-03-20 23:55Christian GrothoffStatusinforming => closed