Auto merge of #911 - micbou:update-api-docs, r=Valloric

[READY] Update API documentation

The website containing the API docs wasn't updated when merging PR #857 (the `/receive_messages` handler is missing). This PR fixes some typos, renames `openapi.yaml` to `openapi.yml`, and updates the website.

<!-- Reviewable:start -->
---
This change is [<img src="https://reviewable.io/review_button.svg" height="34" align="absmiddle" alt="Reviewable"/>](https://reviewable.io/reviews/valloric/ycmd/911)
<!-- Reviewable:end -->