W3C home > Mailing lists > Public > spec-prod@w3.org > April to June 2020

Introducing specification series in the W3C API

From: Denis Ah-Kang <denis@w3.org>
Date: Wed, 24 Jun 2020 14:48:09 +0400
To: Spec-prod <spec-prod@w3.org>
Message-ID: <6eecf67d-dbd5-c2cc-4727-4b6569707e50@w3.org>
Hi,

I am pleased to announce that the W3C API is now providing
data about specification series. A series is basically
a group of specifications published with different level
numbers, e.g. CSP (for CSP1, CSP2, CSP3) and css-color (for
css-color-3, css-color-4, css-color-5).

There are 2 new endpoints [1] for the specification series,
taking the shortname without version as parameter:
- https://api.w3.org/specification-series/<shortname>
- https://api.w3.org/specification-series/<shortname>/specifications

These endpoints return the list of specifications associated
with a series and the 'current' specification which is the one
that is served when you access
https://www.w3.org/TR/<shortname-without-version>/

Regarding the specifications themselves, if there was a change
of shortname or if you use the series shortname you will be
redirected to the right specification. See examples below:
[[
$ curl -I -L "https://api.w3.org/specifications/webrtc-dscp?apikey=@apikey@
HTTP/1.1 301 Moved Permanently
...
location: /specifications/webrtc-priority?apikey=@apikey@
...
HTTP/1.1 200 OK
...

$ curl -I -L "https://api.w3.org/specifications/CSP?apikey=@apikey@
HTTP/1.1 301 Moved Permanently
...
location: /specifications/CSP3?apikey=@apikey@
...
HTTP/1.1 200 OK
...
]]

Let me know if you have any questions.

Denis

[1] https://api.w3.org/doc#operations-tag-Series
Received on Wednesday, 24 June 2020 10:48:18 UTC

This archive was generated by hypermail 2.4.0 : Wednesday, 24 June 2020 10:48:19 UTC