Add a public API definition (#4792)

* docs(APIdefinition.md): Added.

* doc(APIdefinition.md): Typo fix.

* Added language suggested by jessemapel.

* Removed "contents" from description of structured output files, due to
potential misunderstanding.

* Added some wording based on PR discussion.