API - FI
Johdanto
API:n käyttöönotto edellyttää seuraavaa:
Aktiivinen Smart Sender -tili ja luotu projekti.
Tilin todennustunnus (API-tunnus / käyttöoikeustunnus) – yksilöllinen tilin tunniste, jota käytetään tilisi vahvistamiseen kaikissa API-pyynnöissä.
Tärkeä huomautus kehittäjille: Smart Sender API:n raja on 180 pyyntöä minuutissa.
Kun tämä raja ylittyy, 60 sekunnin lukitus tapahtuu ensimmäisen kerran. Joka kerta kun linjaraja ylittyy, esto kasvaa 60 sekuntia (toinen ylitys - 120 sekunnin esto, kolmas - 180 jne.), mutta enintään 720 sekuntia.
Voit hallita sallittujen pyyntöjen määrää X-Rate-Limit-otsikolla.
Todennustunnus
Todennustunnus (tunnetaan myös nimellä sovellusavain) on tilin ainutlaatuinen ja salainen tunniste. Sitä käytetään pyynnön todentamiseen Smart Sender API:lle ja estämään kolmansia osapuolia lähettämästä pyyntöjä projektin puolesta. Jokaisen API-pyynnön tulee sisältää HTTP-otsikko nimeltä Authorization
, joka sisältää tilin todennustunnuksen.
HTTP header
Authorization: Bearer O1CpCRhOVuXpMVf5e0An9DMwrn8w7b8CwskbhIBUjgOJ3B2vYzbFZum3oBOF
Todennustunnus luodaan, kun projekti luodaan, ja projektin pääkäyttäjät voivat tarkastella tai muokata sitä valitun projektin Integraatiot-välilehdellä.
Huomautus. Jos et lähetä todennustunnusta otsikossa, se lähettää virheilmoituksen viestin mukana “Unauthenticated
“.