Preskoči na sadržaj

Autentifikujte API zahtjev

Pošaljite Threetone API ključ u zaglavlju x-api-key i držite vjerodajnicu izvan klijentskog koda.

Ažurirano

Pošaljite API ključ u zaglavlju

Javni programski API dostupan je na adresi https://api.threetone.in. Pošaljite API ključ u zaglavlju zahtjeva x-api-key:

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

Ključ koristite kao vrijednost zaglavlja. Nemojte ga stavljati u URL, niz upita ni tijelo zahtjeva. Programsko slanje zahtjeva treba koristiti x-api-key; slanje istovremeno sa zaglavljem Authorization odbija se jer je dvosmisleno.

Zadržite ključ na serveru

Učitajte ključ iz upravljača tajnama na serveru ili varijable okruženja. Nemojte ga ugrađivati u JavaScript za preglednik, pakete mobilnih aplikacija, zapisnike ni poruke o grešci. Za svaku implementiranu integraciju koristite zaseban, usko ograničen ključ kako curenje jednog ključa ne bi izložilo nepovezane operacije.

Zabilježite ID zahtjeva

Threetone vraća zaglavlje odgovora X-Request-Id. Tokom otklanjanja problema sačuvajte tu vrijednost uz vrijeme zahtjeva, metod, putanju i status. Možete poslati i vlastiti važeći X-Request-Id; API ga vraća u odgovoru.