API dokumentácia

Verejné API AIDEAL. Autentifikácia hlavičkou x-api-key (kľúč vygenerujete v Nastavenia → API).

Autentifikácia

Každá požiadavka musí obsahovať hlavičku x-api-key s vaším kľúčom (vygenerujete v Nastavenia → API). Verejné API je dostupné od plánu growth.

Rýchly štart

cURL

curl https://aideal.sk/api/v1/quotes \
  -H "x-api-key: VAS_API_KLUC"

Node.js

const res = await fetch("https://aideal.sk/api/v1/quotes", {
  headers: { "x-api-key": process.env.AIDEAL_API_KEY },
});
const { quotes } = await res.json();

Python

import requests
r = requests.get("https://aideal.sk/api/v1/quotes",
                 headers={"x-api-key": AIDEAL_API_KEY})
quotes = r.json()["quotes"]

Endpointy

GET/api/v1/quotes

Zoznam ponúk

Vráti posledných 100 ponúk tenanta (podľa API kľúča). Vyžaduje plán growth+.

Webhooky

AIDEAL pošle POST na vašu webhook URL (Nastavenia → API). Payload: { event, data, at }.

quote.signed — Ponuka bola podpísaná klientom.

quote.paid — Ponuka bola zaplatená.