Ves al contingut

Autentica una sol·licitud a l'API

Envia una clau d'API de Threetone a la capçalera x-api-key i mantén la credencial fora del codi del client.

Actualitzat

Envia la clau d'API a la capçalera

L'API pública programàtica està disponible a https://api.threetone.in. Envia la clau d'API a la capçalera de la sol·licitud x-api-key:

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

Fes servir la clau com a valor de capçalera. No la posis en una URL, una cadena de consulta ni el cos de la sol·licitud. Les sol·licituds programàtiques han d'enviar x-api-key; si també s'envia una capçalera Authorization, la sol·licitud es rebutja perquè és ambigua.

Mantén la clau al servidor

Carrega la clau des d'un gestor de secrets del servidor o d'una variable d'entorn. No la incorporis al JavaScript del navegador, als paquets d'aplicacions mòbils, als registres ni als missatges d'error. Fes servir una clau diferent i amb permisos estrictament limitats per a cada integració desplegada perquè una filtració no exposi operacions no relacionades.

Registra l'identificador de la sol·licitud

Threetone retorna la capçalera de resposta X-Request-Id. Per resoldre problemes, conserva aquest valor amb l'hora, el mètode, la ruta i l'estat de la sol·licitud. També pots enviar el teu propi X-Request-Id vàlid; l'API el retorna a la resposta.

Articles relacionats