Todentaminen

Todentaminen

Authorization: ApiKey

API-avain lähetetään vain POST /api/v1/auth/token -pyynnön Authorization-otsakkeessa. Älä lisää sitä JSON-sisältöön, URL-osoitteeseen tai kyselyparametreihin.

Authorization: Bearer

Käytä palautettua tunnusta resurssipyyntöihin ja uusi se expires_at-arvon mukaan. expires_in ilmaistaan sekunteina.

Miksi tunniste haetaan ensin?

API-avaimella haetaan käyttötunniste. Tunniste on voimassa 15 minuuttia ja sopii useisiin pyyntöihin. Lähetä resursseille vain tunniste Authorization: Bearer -otsakkeessa.

Tavalliset pyynnöt eivät sisällä API-avainta. Vuotanut tunniste mahdollistaa pääsyn enintään voimassaolonsa loppuun. Varastetulla API-avaimella voi silti olla mahdollista hakea uusia tunnisteita.

Kuinka kauan tunniste on voimassa?

expires_in

900 sekuntia eli 15 minuuttia myöntämisestä. Pyyntöjen tekeminen ei pidennä voimassaoloa.

expires_at

Vanhenemisajankohta UTC-ajassa. Nykyiset käyttörajoitukset voivat estää tunnisteen käytön jo aiemmin.

Milloin uusi tunniste haetaan?

Käytä samaa tunnistetta useisiin pyyntöihin ja hae uusi ennen expires_at-ajankohtaa. Älä hae tunnistetta ennen jokaista toimintoa. Käytä uuden tunnisteen hakemiseen API-avainta.

Ensimmäinen pyyntö

Pääsy estetty ja uudet yritykset

401

401 ei aina tarkoita, että tunniste on vanhentunut. Jos se on vanhentunut, hae uusi ja toista lukupyyntö enintään kerran. Jos tunnisteen haku palauttaa 401:n, tarkista avain ja lopeta automaattiset yritykset.

403

Tarkista 403-virheen yhteydessä oikeudet, IP-rajoitukset ja tilaus. Uusi tunniste ei palauta peruttua käyttöoikeutta.

IP-rajoitukset

• Käyttöoikeustunnus ei ohita avaimen nykyisiä käyttöoikeuksia, kaupan pakettioikeuksia, peruutusta tai IP-rajoituksia.
• Rajoita avain tarvittaessa integraation lähdeosoitteisiin.
• Ylläpitäjä voi muokata tätä luetteloa.
• Enintään 32 osoitetta hyväksytään.

Avainten hallinta

• API-avainten hallinta on erillinen integraation resurssioikeuksista.
• Vain owner voi antaa ryhmille hallinnolliset oikeudet avainten katseluun, luontiin, muokkaamiseen tai poistamiseen.
• Valtuutettu ryhmän jäsen voi suorittaa vain ryhmälle myönnetyt toiminnot.

Käyttöoikeudet ja paketit

Virheet ja palautuminen

Pyyntörajat

Engine ≥ 4.143.0. Jokainen tokenvastaus sisältää myöntämishetken kauppakäytännön data.rate_limits-arvot. Kaikki avaimet jakavat nämä kiintiöt; uusi token ei nollaa niitä. Tilausmuutos voi tulla voimaan ennen tokenin vanhenemista.

read_per_minute

Lukupyyntöjä minuutissa.

write_per_minute

Kirjoituspyyntöjä minuutissa; arvo ei myönnä kirjoitusoikeuksia.

auth_per_minute

Tokenpyyntöjä minuutissa, mukaan lukien epäonnistuneet tunnistautumisyritykset.

Pyyntörajat

Toiminnot