Siirry sisältöön

Todenna API-pyyntö

Lähetä Threetonen API-avain x-api-key-otsakkeessa ja pidä tunnistetieto poissa asiakaspuolen koodista.

Päivitetty

Lähetä API-avaimen otsake

Julkinen ohjelmallinen API on osoitteessa https://api.threetone.in. Lähetä API-avain pyynnön x-api-key-otsakkeessa:

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

Käytä avainta otsakkeen arvona. Älä sijoita sitä URL-osoitteeseen, kyselymerkkijonoon tai pyynnön runkoon. Ohjelmallisen pyynnön tulee lähettää x-api-key; sen lähettäminen yhdessä Authorization-otsakkeen kanssa hylätään monitulkintaisena.

Säilytä avain palvelimella

Lataa avain palvelinpuolen salaisuuksienhallinnasta tai ympäristömuuttujasta. Älä sisällytä sitä käyttöliittymän JavaScriptiin, mobiilisovellusten paketteihin, lokeihin tai virheilmoituksiin. Käytä kullekin käyttöönotetulle integraatiolle erillistä, tarkasti rajattua avainta, jotta yhden tunnistetiedon vuotaminen ei paljasta muita toimintoja.

Tallenna pyynnön tunniste

Threetone palauttaa vastauksessa X-Request-Id-otsakkeen. Tallenna sen arvo yhdessä pyynnön aikaleiman, metodin, polun ja tilan kanssa vianmääritystä varten. Voit myös lähettää oman kelvollisen X-Request-Id-arvosi; API palauttaa sen vastauksessa.