The Ding API is a REST API and uses standard HTTP features and statuses.

The current URL is https://api.ding.live/v1.

Authentication

To perform requests on the API, you need to provide two secrets:

  • API_TOKEN - a token that identifies your application in the x-api-key header.
  • CUSTOMER_UUID - a token that identifies your app in the customer_uuid request body field.

You can get them in the Settings > API tab of the Dashboard.

Example request
curl --request POST \
     --url 'https://api.ding.live/v1/*' \
     --header 'Accept: application/json' \
     --header 'x-api-key: YOUR_API_TOKEN'

Errors

The Ding API returns errors using a JSON object in the response body with a machine-readable code and a human-readable message.

See Errors for more details.


SDKs

Ding offers SDKs for the most popular languages:

Reference

Explore the Ding API reference to learn more about the available endpoints: