What are the benefits of using the SDK? - AquaticInformatics/aquarius-sdk-net GitHub Wiki

The SDK has encapsulated much of the ceremony / drudgery of consuming REST APIs.

  • Deployed via Nuget (or, for the Java SDK, via Maven) for super easy integration into your code.
  • Authentication is handled for you. Provide your credentials to the SDK and allow it to adapt to any product-specific differences.
  • JSON serialization is handled for you. Your integrations will never need to parse JSON text streams. All requests and responses are objects, not text strings. This value is huge!
  • Service model classes are always up-to-date. When a new version of AQTS adds a new API, the matching SDK will contain the request & response DTOs required for integration.
  • Error handling is consistent.
  • The SDKs tend to be "battle-tested". Many AI Source offerings and other AQUARIUS products consume the SDKs internally.

Yup, you can implement each of those bullet items differently, on your own, for you specific use-case. But you likely don't need to.