Re: Introducing specification series in the W3C API

"Tobie Langel" <[email protected]> Wed, 24 Jun 2020 12:51:38 +0200
Newsgroups gmane.org.w3c.specifications
Message-ID <[email protected]>
This looks awesome.

In the future, can you reach out while you=E2=80=99re building those so =
consumers can have more direct input?

Apologies if you have and I missed that.

Thanks,

=E2=80=94tobie

On Wed, Jun 24, 2020, at 12:48, Denis Ah-Kang wrote:
> Hi,
>=20
> 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).
>=20
> 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
>=20
> 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>/
>=20
> 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=3D@=
apikey@
> HTTP/1.1 301 Moved Permanently
> ...
> location: /specifications/webrtc-priority?apikey=3D@apikey@
> ...
> HTTP/1.1 200 OK
> ...
>=20
> $ curl -I -L "https://api.w3.org/specifications/CSP?apikey=3D@apikey@
> HTTP/1.1 301 Moved Permanently
> ...
> location: /specifications/CSP3?apikey=3D@apikey@
> ...
> HTTP/1.1 200 OK
> ...
> ]]
>=20
> Let me know if you have any questions.
>=20
> Denis
>=20
> [1] https://api.w3.org/doc#operations-tag-Series
>=20
>