An SDK is so much more powerfull in providing an expressive and meaningfull API,
including the communication of deprecated methods, typings, because it can be
written to suit your domain, and does not neet to fit in the REST vocabulary.