Raw RESTful request examples
Your API is RESTful (http request/response) but you do not provide raw HTTP request examples. You only provide examples which use cURL, C# classes, etc., which has the effect of concealing your actual API. IMO this is ridiculous that you don't actually document the API itself, which consists of HTTP/HTTPS requests and responses.
You don't need to document the responses. But I definitely need you to document example HTTP / HTTPS requests.
1
vote
