Loading
Ymmärrä, miten botti-ID toimii widgetin tunnisteena ja miten REST-rajapinnan avain eroaa siitä.
EquilAI:lla on kaksi tunnistetta kahteen tehtävään. Verkkosivuwidget tunnistautuu julkisella botti-ID:llä, joka on koodinpätkässä eikä vaadi tokenia. Palvelinpuolen REST-rajapinta käyttää salaista API-avainta, jonka luot hallintapaneelissa, ja se kuuluu vain palvelimellesi.
Miten se toimii
Jokaisella botilla on ainutkertainen UUID, joka annetaan luontihetkellä. Tämä ID:
Botti-ID:si (esimerkki)
a1b2c3d4-e5f6-7890-abcd-ef1234567890Löydät oikean botti-ID:si kohdasta Hallintapaneeli → Käyttöönotto.
Widgetin todennus
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 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
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.
Mitä tämä tarkoittaa käytännössä:
403Valmis aloittamaan integroinnin? Katso REST-rajapinta →