And here I thought I knew full well what RESTful APIs had to look like. The constraint in my head was that individual resources (e.g. items in a database) should have their own URL and you used the HTTP verbs (
DELETE, etc.) correctly.
What was missing from that is the Hypermedia aspect, where each response defines the appropriate URLs for the possible next steps.More...