1427734 - Publish a swagger.json

Status: RESOLVED WONTFIX

(Socorro :: Symbols, task)

Description

[Peter Bengtsson [:peterbe]]

E.g. https://pollbot.dev.mozaws.net/v1/api/doc/swagger.json

Let's not just publish this but actually "use it". We can have a Django middleware that checks all incoming and outcoming traffic against the swagger.json to make sure it is up-to-date.

Comment 1

[Peter Bengtsson [:peterbe]]

Not worth the effort since the few consumers of the API can get everything they need from the Frontend and its built-in documentation. And the other API endpoints, such as symbol upload, aren't something people need documented in a swagger file.