Ask HN: What does a great API product need to have?

[ioanarebeca]

What does a great API product meant to you? Any remarkable experiences (or shout-outs) while developing using an API?

[shortrounddev]

- RESTful interfaces are still the most intuitive

- A Jsonschema defining the inputs and outputs is extremely helpful