4 ms·

I really like the Shopify API, clear and easy to use.

• QueensGambit 7y ago
  Like good code, good API should be understandable when you see its endpoints, even without reading at its documentation. Shopify falls in that category. But, I end up searching in its forums to reach an API, which doesn't say much about its documentation.
  • afarrell 7y ago
    Have you ever seen an API which is understandable only from its endpoints and no documentation?
    • tuananh 7y ago
      sound like a GET request :)
  • dmlittle 7y ago
    While you might be able to infer what a certain endpoint does based on context. For example: POST https://api.stripe.com/v1/charges https://api.stripe.com/v1/charges will create a CC charge POST https://api.lob.com/v1/letters https://api.lob.com/v1/letters will mail a letter There's no way you know what the parameters to each endpoint are without proper documentation. If the API has good validation you might be able to make a request work but you won't know the full extent of the APIs capabilities without documentation.