Integraatiot

​

Määritelmä

Asetukset → Integraatiot ja API -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ä.

​

Tilin ID:t

Jokainen API-kutsu ja webhook-hyötykuorma viittaa tilin tunnukseesi (tenant-tunniste). Tilin ID:t -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 uusi avain Luo avain -painikkeella — koko avain näytetään kerran.
• Jokaisesta avaimesta näkyy sen nimi, luontiaika ja luonut käyttäjä.
• Poista avain milloin tahansa. Avain lakkaa toimimasta välittömästi, eikä poistoa voi perua.
• API-avaimella tehdyt kutsut kirjautuvat kyseiselle avaimelle tapahtumalokiin (tekijä näkyy muodossa API: <label>).

Käyttö ja kutsurajat on kuvattu sivulla API-avaimet.

​

Webhookit

Webhookit lähettävät tapahtumia TWICEstä järjestelmiisi lähes reaaliajassa. Jokaisella webhookilla on: Yksi webhook kuuntelee tasan yhtä tapahtumatyyppiä ja koskee koko tiliä — luo yksi webhook 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.

​

Miten integraatiodata liikkuu

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

​

Aiheeseen liittyvät artikkelit