Certainly not perfect build we wrote this spec for the National Bank of Belgium a few years ago. Served us well.

https://github.com/NationalBankBelgium/REST-API-Design-Guide...