Aqbeż għall-kontenut

Awtentika talba tal-API

Ibgħat iċ-ċavetta tal-API f’header, żommha fuq is-server u rreġistra l-ID tat-talba.

Aġġornat

Ibgħat l-header taċ-ċavetta tal-API

L-API pubblika programmabbli hija fuq https://api.threetone.in. Ibgħat iċ-ċavetta fl-header x-api-key tat-talba:

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

Uża ċ-ċavetta bħala valur tal-header. Tpoġġihiex f’URL, query string jew fil-korp tat-talba. Talba programmabbli għandha tibgħat x-api-key; jekk tibgħatha wkoll ma’ header Authorization, tiġi rrifjutata minħabba ambigwità.

Żomm iċ-ċavetta fuq is-server

Għabbiha minn maniġer ta’ sigrieti tas-server jew varjabbli tal-ambjent. Tinkludihiex f’JavaScript tal-frontend, pakketti ta’ apps mobbli, logs jew messaġġi ta’ żball. Uża ċavetta separata u b’ambitu ristrett għal kull integrazzjoni mħaddma, sabiex ċavetta waħda li tnixxi ma tikxifx operazzjonijiet oħra.

Żomm l-ID tat-talba

Threetone jirritorna header X-Request-Id fit-tweġiba. Żomm dak il-valur flimkien mal-ħin, il-metodu, il-passaġġ u l-istatus tat-talba għas-soluzzjoni tal-problemi. Tista’ tibgħat ukoll X-Request-Id validu tiegħek; l-API tirrepetih fit-tweġiba.