Standardize formatting of links to the API reference

[dichotommy]

We haven't quite decided on a format yet, but when we have we would like to standardize the formatting of links to the API references from outside that section, and possibly the way we write about API endpoints in general.

See this conversation about pros and cons of different styles.