Skip to content

feat: discovery by PURL as an alternative to TEI - #265

Merged
oej merged 2 commits into
CycloneDX:mainfrom
relizaio:2026-09-discovery-by-purl
Sep 10, 2026
Merged

oej merged 2 commits into
CycloneDX:mainfrom
relizaio:2026-09-discovery-by-purl

Conversation

@taleodor

@taleodor taleodor commented Sep 10, 2026

Copy link
Copy Markdown
Contributor

/discovery accepts either tei or purl; exactly one shall be given, a request with neither or both is rejected with 400. OpenAPI cannot express that constraint across query parameters, so tei becomes optional and the rule is stated in the descriptions.

Discovery by TEI resolves across TEA servers through the domain the TEI carries; discovery by PURL resolves within the inventory of the server receiving the request, since a PURL carries no domain.

Spec only; documentation unchanged to prevent conflicts with #261 . Validated with openapi-generator v7.12.0 (validate; Go batch generation as CI runs it).

/discovery accepts either `tei` or `purl`; exactly one shall be given, a
request with neither or both is rejected with 400. OpenAPI cannot express
that constraint across query parameters, so `tei` becomes optional and
the rule is stated in the descriptions.

Discovery by TEI resolves across TEA servers through the domain the TEI
carries; discovery by PURL resolves within the inventory of the server
receiving the request, since a PURL carries no domain.

Spec only; documentation unchanged. Validated with openapi-generator
v7.12.0 (validate; Go batch generation as CI runs it).

Signed-off-by: Pavel Shukhman <pavel@reliza.io>
@taleodor
taleodor requested review from madpah and oej as code owners September 10, 2026 13:09
Comment thread spec/openapi.yaml Outdated
Comment thread spec/openapi.yaml Outdated
Signed-off-by: Pavel Shukhman <pavel@reliza.io>
@oej
oej merged commit 8fcc2f3 into CycloneDX:main Sep 10, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants