1196191 - [Meta] Make it easier to start submitting data to Treeherder's API

Status: RESOLVED INCOMPLETE

(Tree Management :: Treeherder: API, defect, P3)

Description

[Ed Morley [:emorley]]

The initial focus for Treeherder was to reach feature parity with TBPL, in order that TBPL could be EOLed. During that time fixing a number of API papercuts was deferred, since third-party result submissions were not supported by TBPL and as such did not block switching TBPL off.

Since then we've fixed a few issues (and improved the Python client, added API versioning etc), but many of these papercuts still exist, and make for a frustrating experience when people first start submitting to our API.

I believe there are a few quick wins that would help considerably, eg:
* Improved documentation
* json schema validation, along with decent error messages returned by the API (as opposed to just dropping things on the floor when fields are missing)

To the people CCed - if there's something that would have made getting set up with submitting to our API easier - please file a bug/let us know :-)

Comment 1

[Ed Morley [:emorley]]

Submitting jobs/pushes via the API is now discouraged in favour of using Pulse (bug 1349182), so we're wontfixing API-specific issues.