Document the API

[foolip]

Is your feature request related to a problem? Please describe.

I'd like to enumerate Chrome launches between Chrome 72 and 120, covering the 5 years 2019-2023. Using DevTools, I figure out I could use the following URL:

https://chromestatus.com/api/v0/features?q=browsers.chrome.desktop%3E%3D72+browsers.chrome.desktop%3C%3D120

However, I found that the response begins with )]}' and isn't valid JSON. Stripping characters up to the first { seems to work.

Describe the solution you'd like

Document the API and make it possible to use for external code.

Additional context

The purpose of all this is to make a spreadsheet of recent launches and map them to https://github.com/web-platform-dx/web-features.

[foolip]

This is the view I started from:
https://chromestatus.com/newfeatures?q=browsers.chrome.desktop%253E%253D72%2520browsers.chrome.desktop%253C%253D120&start=100

[rachelandrew]

I've just run into the same issue with the JSON, would be great to have some docs for the API (and to fix this issue!)

[jrobbins]

The prefix is for security. See go/xssi fifth bullet item. Client code should strip those characters from the response.

[foolip]

I see. It would be good to document what rules a client should apply. Is it to always strip a fixed number of bytes regardless of the response, or perhaps to expect the bytes )]}' plus a newline and fail if it's some other sequence?

[jrobbins]

It should always that sequence with the newline, so clients can count on that.