Quickstart

Every request to the Airzone Control API is authenticated with an API key and scoped to a market and a locale via request headers.

Headers

string

required

Your API key. Replace YOUR_API_KEY in the examples with the key provided to you.

string

required

The market to query. Determines the catalog and availability rules that apply. See Markets & locales.

string

required

The language for the response content. See Markets & locales.

string

Set to application/json.

Your first request

This call lists the brands that have at least one indoor unit compatible with the AIDOO_KNX controller. Swap app-market and app-locale for the values that match your client’s region.

curl --location 'api.airzonecloud.com/msproduct.pv1/compatibilities/types/AIDOO_KNX/brands' \
  --header 'Content-Type: application/json' \
  --header 'apikey: YOUR_API_KEY' \
  --header 'app-market: eu' \
  --header 'app-locale: en'

const res = await fetch(
  "https://api.airzonecloud.com/msproduct.pv1/compatibilities/types/AIDOO_KNX/brands",
  {
    headers: {
      "Content-Type": "application/json",
      apikey: "YOUR_API_KEY",
      "app-market": "eu",
      "app-locale": "en",
    },
  }
);
const data = await res.json();

import requests

url = "https://api.airzonecloud.com/msproduct.pv1/compatibilities/types/AIDOO_KNX/brands"
headers = {
    "Content-Type": "application/json",
    "apikey": "YOUR_API_KEY",
    "app-market": "eu",
    "app-locale": "en",
}

data = requests.get(url, headers=headers).json()

Never expose your API key in client-side code. Proxy requests through your own backend so the key is never shipped to the browser.

Next steps

Markets & locales

Pick the right app-market and app-locale for any region.

Compatibilities

Walk through the full compatibility selector flow.

Getting Started

Core concepts

API Reference

Headers

Your first request

Next steps

Markets & locales

Compatibilities

​Headers

​Your first request

​Next steps

Markets & locales

Compatibilities

Headers

Your first request

Next steps