Skip to main content
Integraatioasetukset hallinnassa

Asetukset > Integraatiot

Määritelmä

Asetukset > Integraatiot -sivulla kytket TWICEn muuhun järjestelmäympäristöösi. Se näyttää tunnisteen, tunnistetiedot ja webhook-päätepisteet, joita ulkoiset järjestelmät tarvitsevat lukeakseen TWICEstä tai lähettääkseen sinne dataa.

Mitä hallinnassa on

Maksupalveluntarjoajat määritetään erikseen kohdassa Asetukset → Maksut, ei täällä.

Account ID

Jokainen API-kutsu ja webhook-hyötykuorma viittaa kauppiastunnukseesi (tenant-tunniste). Account ID -kortti näyttää sen ja tarjoaa yhden napsautuksen kopioinnin. Jaa se kumppanille tai kehittäjälle, joka rakentaa integraatiota tiliäsi vasten.

API-avaimet

API-avaimet tunnistavat kutsut TWICEn hallinnan API:iin.
  • Luo avain Create key -toiminnolla — koko avain näytetään kerran.
  • Jokaisesta avaimesta näkyy sen nimi, luontiaika ja luonut käyttäjä.
  • Avaimen voi kumota milloin tahansa — kumoaminen astuu voimaan välittömästi.
  • API-avaimella tehdyt kutsut kirjautuvat kyseiselle avaimelle tapahtumalokiin (tekijä näkyy muodossa API: <label>).
API-avaimet antavat pääsyn koko tiliin — avainkohtaisia oikeusrajauksia ei ole. Käsittele niitä kuin salasanoja äläkä koskaan tallenna niitä versionhallintaan.
Käyttö ja kutsurajat on kuvattu sivulla API-avaimet.

Webhookit

Webhookit lähettävät tapahtumia TWICEstä järjestelmiisi lähes reaaliajassa. Jokaisella tilauksella on: Yksi tilaus kuuntelee tasan yhtä tapahtumatyyppiä ja koskee koko tiliä — luo yksi tilaus kutakin haluamaasi tapahtumaa kohden. Tällä hetkellä lähetetään tilauksen elinkaaritapahtumat: order.created, order.updated ja order.deleted. Hyötykuorman muoto on kuvattu sivulla Webhookit.
Webhookit edellyttävät niitä sisältävää pakettia — muut tilit näkevät päivityskehotteen. Katso paketit.

Miten integraatiodata liikkuu

Saapuvat pyynnöt tunnistautuvat API-avaimella; lähtevät tapahtumat kulkevat webhookeina. Kauppiastunnus rajaa molemmat suunnat tilillesi.

Aiheeseen liittyvät

API-avaimet

Tunnistaudu ja kutsu hallinnan API:a

Webhookit

Tilaa tapahtumia