the most effective way to document the scope and functionality of an API is to publish the code and data examples used to validate it alongside the API contract - Be sure to include standard and custom error response codes and interpret their specific meaning