API Versions

This page details the differences between our different API versions. Thredd currently supports three different APIs:

• Web Services uses Simple Object Access Protocol (SOAP) for exchanging structured information in the implementation of web services, which uses XML for it's message format.

  

• Cards API uses is based on RESTful principles. and accepts JSON-encoded request bodies and returns JSON-encoded responses. Depending on the environment you're using, the base URL for the endpoint differs.

  

• API Hub is also based on RESTful principles, accepting JSON-encoded request bodies and returns JSON-encoded responses. Where it differs from Cards API is how you connect to an environment. API Hub uses a single URL so you don't have to change your base-url if you want to connect to a different environment. Instead, API Hub uses the X-Header in the header of the HTTPS request to specify the environment the API calls.