distribution-spec icon indicating copy to clipboard operation
distribution-spec copied to clipboard

Inconsistent specification for endpoint end-8b's (`.../tags/list`) parameter `last`.

Open nairb774 opened this issue 3 years ago • 1 comments

The specification of the last query parameter differs between the Endpoints table and the textual description in the "Content Discovery" section. The Endpoints table lists the API endpoint as /v2/<name>/tags/list?n=<integer>&last=<integer> - notice that last is specified as an <integer>. The "Content Discovery" section lists the API endpoint as /v2/<name>/tags/list?n=<int>&last=<tagname> and provides this additional commentary:

... <tagname> is the value of the last tag. <tagname> MUST NOT be a numerical index, but rather it MUST be a proper tag.

If I had to guess, the Endpoints table is incorrect and should be updated to match the specification described in the "Content Discovery" section.

nairb774 avatar Jun 18 '22 20:06 nairb774

The specification of the last query parameter differs between the Endpoints table and the textual description in the "Content Discovery" section. The Endpoints table lists the API endpoint as /v2/<name>/tags/list?n=<integer>&last=<integer> - notice that last is specified as an <integer>. The "Content Discovery" section lists the API endpoint as /v2/<name>/tags/list?n=<int>&last=<tagname> and provides this additional commentary:

... <tagname> is the value of the last tag. <tagname> MUST NOT be a numerical index, but rather it MUST be a proper tag.

If I had to guess, the Endpoints table is incorrect and should be updated to match the specification described in the "Content Discovery" section.

HOALND avatar Jun 24 '22 11:06 HOALND