API - FI

Johdanto

API:n käyttöönotto edellyttää seuraavaa:

  1. Aktiivinen Smart Sender -tili ja luotu projekti.

  2. 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“.