Hi notm84 -
Unless you want to create your own SDK, you most definitely want to use one of the existing SDK’s (Java, .NET, Ruby, Node.js, etc) instead of using the REST API’s directly.
The documentation exists to help library developers create clients for platforms/languages not currently supported or do not have an official SDK.
Thanks,
Jeff