Todennus

Miten se toimii

Botti-ID:si

Jokaisella botilla on ainutkertainen UUID, joka annetaan luontihetkellä. Tämä ID:

• →Tunnistaa, mikä botti ladataan ja jonka kanssa keskustellaan
• →On upotettu widgetin koodinpätkän URL:iin
• →On julkisesti näkyvä; se ei ole salaisuus (toisin kuin REST-rajapinnan avain)

Botti-ID:si (esimerkki)

a1b2c3d4-e5f6-7890-abcd-ef1234567890

Löydät oikean botti-ID:si kohdasta Hallintapaneeli → Käyttöönotto.

Widgetin todennus

Koodinpätkä

Widget-upotuksessa todennus on implisiittinen: botti-ID:si on osa koodinpätkän URL:ia. Lisämäärityksiä ei tarvita, ja widget hoitaa jokaisen kutsunsa siitä eteenpäin itse.

<!-- Your Bot ID is embedded in the script URL -->
<script data-cfasync="false">
  (function () {
    var s = document.createElement("script");
    s.src = "https://equilai.ai/api/widget/script/YOUR_BOT_ID.js";
    s.async = true;
    document.head.appendChild(s);
  })();
</script>

REST-rajapinnan todennus

Palvelinpuolen API-avain

Palvelinpuolen REST-rajapinta käyttää salaista API-avainta botti-ID:n sijaan. Luo sellainen kohdassa Hallintapaneeli → API ja lähetä se sitten JSON-rungossa kenttänä apiKey. Toisin kuin botti-ID, tämä avain on salaisuus: pidä se palvelimellasi äläkä koskaan paljasta sitä selainpuolen koodissa. Katso API-viite →

POST /api/chat/start

{ "apiKey": "YOUR_API_KEY" }

Turvallisuus

Verkkotunnusrajoitukset

Koska botti-ID on julkinen, widgetin pyynnöt validoidaan myös alkuperäverkkotunnuksen perusteella. Hallitset sitä, mitkä sivustot saavat upottaa bottisi kohdassa Hallintapaneeli → Botti → Sallitut verkkotunnukset. REST-rajapintaa ei ole rajattu verkkotunnuksen mukaan; sen salainen avain on tunniste.