November 29, 2019 | 2 Min

Our new and improved API documentation

author

Olly Secluna

  • Product updates

Build with confidence

We're pleased to announce our new documentation for the Amplience Dynamic Content Management API.

Utilising the React based ReDoc framework and the OpenAPI format, the new documentation is easy to navigate and contains accurate examples of both requests and responses, as well as a full API spec that can be imported into your favourite API development tool.

Guides on how to authorize, use HAL links and common status codes are also included. In short the new docs mean you can get started with our APIs more quickly, validate your ideas and try things out before building anything.

You can find the new docs here.

Import the OpenAPI spec

OpenAPI is compatible with API development tools such as Insomnia and Postman , so you can download the entire API spec from our new documentation and import it into your chosen tool.

The button to download the spec can be found at the top of the documentation, or if you want to import directly from a URL without downloading the spec first, you can use:

1https://docs.amplience.net/api/dynamic-content/management/openapi.json

Run in Insomnia

For insomnia users I have created this handy shortcut, just for fun: Run in Insomnia.

For more information see Insomnia's documentation on Importing and Exporting Data.

Create a Postman collection

To create a collection in Postman, import the Open API spec and tick the option 'Generate a Postman Collection'. This will generate a collection called Dynamic Content - Management API, with a folder for each endpoint. See Postman's documentation for more information: Working with OpenAPI in Postman.

What next

We will be migrating more of our APIs into the OpenAPI format and integrating them into our new UI in the near future.

As the new features of the ReDoc framework are released, we will evaluate whether they are useful to our customers. One potential feature is a built-in API Console, but keep an eye out for more changes coming soon.

Customizable webhooks: integration without the effort

Use customizable webhooks to send data directly from Dynamic Content to 3rd party APIs, reducing integration effort and opening up a world of possibilities.

Olly Secluna

March 16, 2020 | 6 Min

  • Product updates
  • Engineering
  • Guides

How to use the Dynamic Content Zapier integration to build a better workflow

Learn what you can accomplish when you have Dynamic Content, Zapier and the rest of your business apps working together.

Helen Bertram

December 18, 2019 | 7 Min

  • Product updates
  • Guides
Image recognition finding the right image among thousands

Image recognition: finding the right image among thousands

We look at how you can use image recognition to help manage and classify your assets to quickly find the images you need.

Neil Cooper

October 23, 2019 | 10 Min

  • Ecommerce
  • Product updates
  • Guides