Ověřte požadavek API

Odešlete klíč API v hlavičce

Veřejné programové API je dostupné na adrese https://api.threetone.in. Klíč API odešlete v hlavičce požadavku x-api-key:

curl --request GET \
  --url 'https://api.threetone.in/v1/convai/agents' \
  --header "x-api-key: $THREETONE_API_KEY"

Klíč použijte jako hodnotu hlavičky. Nevkládejte ho do adresy URL, řetězce dotazu ani těla požadavku. Programový požadavek má používat x-api-key; současné odeslání hlavičky Authorization je odmítnuto jako nejednoznačné.

Klíč uchovávejte na serveru

Načtěte klíč ze správce tajných údajů na serveru nebo z proměnné prostředí. Nevkládejte ho do JavaScriptu prohlížeče, balíčků mobilních aplikací, protokolů ani chybových zpráv. Pro každou nasazenou integraci použijte samostatný klíč s úzce omezenými oprávněními, aby únik jednoho klíče neohrozil nesouvisející operace.

Zaznamenejte ID požadavku

Threetone vrací hlavičku odpovědi X-Request-Id. Při řešení problémů tuto hodnotu uchovávejte spolu s časem požadavku, metodou, cestou a stavem. Můžete odeslat i vlastní platné X-Request-Id; API ho v odpovědi vrátí.