Skip to main content
API-avaimilla ulkoiset järjestelmät tunnistautuvat TWICE Commercen API:lle — samalle API:lle, jolla hallinta toimii. Käytä niitä integraatioissa, skripteissä ja headless-verkkokaupoissa.

​
Miten se toimii

API-avaimet luodaan ja hallitaan kohdassa Asetukset → Integraatiot osiossa API access. Jokainen avain kuuluu tilillesi ja toimii sen puolesta.
API-avaimia ei ole rajattu. Jokainen avain saa omistajatason oikeudet: se voi kutsua kaikkia tilisi reittejä, mukaan lukien tilausten, asiakkaiden, varaston ja asetusten luku ja kirjoitus. Avainkohtaisia oikeusrajauksia tai rooleja ei ole. Käsittele avainta kuin omistajan salasanaa — säilytä se salaisuutena, älä koskaan tallenna sitä versionhallintaan ja vaihda se välittömästi, jos se vuotaa.
Kaikki pyynnöt menevät osoitteeseen https://server.twicecommerce.com. Lähetä avain X-API-KEY-otsakkeessa jokaisessa pyynnössä. Esimerkiksi katalogin artikkelien listaus:

​
Käyttö

  1. Avaa Asetukset → Integraatiot ja siirry osioon API access.
  2. Luo avain ja kopioi se — koko arvo näytetään vain kerran.
  3. Lisää se integraatioosi X-API-KEY-otsakkeeksi.
  4. Kumoa avain samasta näkymästä, kun sitä ei enää tarvita.

​
Kutsurajat

API rajoittaa pyyntöjä kolmella tasolla:
  • IP-kohtainen — suojaus ennen tunnistautumista. Jokaisella asiakas-IP:llä on minuuttikohtainen pyyntöbudjetti. Pyynnöt, joissa user agent puuttuu tai vaikuttaa botilta, kuluttavat budjettia enemmän kutsua kohden.
  • Tilikohtainen — kaikki tilisi tunnistautunut liikenne (hallinta ja API-avaimet yhteensä) jakaa saman minuuttikohtaisen rajan, joka skaalautuu pakettisi mukaan.
  • API-avainkohtainen — jokaisella avaimella on jatkuva pyyntömäärä sekunnissa, lyhytaikainen purskevara ja kuukausittainen pyyntökatto. Kaikki kolme skaalautuvat pakettisi mukaan; kuukausikatto on API-kutsukiintiö, joka on yhteinen kaikille sijainneillesi.
Vastaukset sisältävät kutsurajaotsakkeet: Kun pyyntö ylittää rajan, API palauttaa 429 Too Many Requests. Odota Retry-After-sekunnit ennen uutta yritystä. Pakettikohtaiset kiintiöt löytyvät TWICE Commercen yleiskatsauksen hinnoitteluosiosta.

​
Aiheeseen liittyvät

API-viite

Selaa kaikkia päätepisteitä.

Webhookit

Vastaanota tapahtumia, kun data muuttuu.

Integraatioasetukset

Hallitse avaimia ja liitettyjä järjestelmiä.