This repository has been archived by the owner. It is now read-only.
Alex Grant edited this page Feb 26, 2017 · 6 revisions

Note: This is not the current API!

The pages linked here document the unfinished WebNews "v1" API, which will eventually replace the current "v0" API likely remain unfinished indefinitely. Keep in mind although this API is served from a separate "staging" site, it still operates on the live production news server. Avoid making posts outside the csh.test groups unless necessary, and clean up any messes you make.


CSH WebNews is a RESTful web service that sits on top of a local NNTP server, providing access to both the underlying news articles and several newsreader-like features (unread post tracking, starring, etc.) via a JSON interface. It uses CSH's Stanford Webauth setup to identify users, and OAuth 2 for authentication.

Versioning

Clients must specify the version of the API they want to use. This version of the API is v1. Any changes made to this version will remain backward-compatible with the original specification. Incompatible changes will only be introduced in new versions, unless such changes are necessary to close a security vulnerability.

Issue Reports

Cases where the observed behavior of the API differs from this documentation should be reported as bugs on the issue tracker. Violations of the versioning policy described above should also be reported. Security issues should be disclosed privately when possible.

Testing the API

Resty is a good tool for sending test requests to the API interactively on the command line. It can be set up to always use the same headers and base URL, avoiding excessive line editing or copy-pasting.

Overview Documentation

Endpoint Documentation

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.