Overiť požiadavku na API
Odošlite kľúč API Threetone v hlavičke x-api-key a uchovávajte prihlasovací údaj mimo klientského kódu.
Aktualizované
Odošlite hlavičku s kľúčom API
Verejné programové API je dostupné na adrese https://api.threetone.in. Kľúč API odošlite v hlavičke požiadavky x-api-key:
curl --request GET \
--url 'https://api.threetone.in/v1/convai/agents' \
--header "x-api-key: $THREETONE_API_KEY"
Kľúč použite ako hodnotu hlavičky. Nevkladajte ho do adresy URL, reťazca dotazu ani tela požiadavky. Programová požiadavka má odoslať x-api-key; súčasné odoslanie hlavičky Authorization sa odmietne pre nejednoznačnosť.
Uchovávajte kľúč na serveri
Kľúč načítajte zo serverového správcu tajomstiev alebo premennej prostredia. Nevkladajte ho do JavaScriptu na klientovi, balíkov mobilných aplikácií, denníkov ani chybových hlásení. Pre každú nasadenú integráciu použite samostatný kľúč s úzko vymedzenými právami, aby únik jednej poverovacej hodnoty neodhalil nesúvisiace operácie.
Zaznamenajte ID požiadavky
Threetone vracia hlavičku odpovede X-Request-Id. Pri riešení problémov si túto hodnotu uložte spolu s časom, metódou, cestou a stavom požiadavky. Môžete poslať aj vlastné platné X-Request-Id; API ho zopakuje v odpovedi.