Last week we got a big PDF with documentation about the almost-but-not-quite-entirely-unlike-REST HTTP API of an external partner. In the section about restrictions of their HTTP API:
For this functionality we recommend to use the SOAP API. This convenient interface offers almost unlimited possibilities to integrate Foo.
Emphasis mine. I have different memories of SOAP.