PostRank

Versioning

The PostRank API is a versioned API. This means that part of the endpoint you'll send API calls to includes a string that identifies the version of the API. It was done this way so that if, in the future, we have a need to change the API in a way that would break the interface contract (i.e., we change the requirements surrounding input, or change the output of existing calls), we can do that without requiring everyone else to rewrite their applications. With a versioned API, we can release a new version with new endpoints, and the older version will continue to work.

Note that adding functionality which does not break backwards-compatibility does not violate the interface contract, so the current version of the API has plenty of room to grow before we need to branch to a new version number.