Webhooks ir adrese tavā sistēmā, uz kuru PIM nosūta ziņu, kad kaut kas notiek — piemēram, produkts mainīts vai imports pabeigts.
Atver Iestatījumi → Webhooki. Pievienot un mainīt var Administrators un Īpašnieks.
Izveidot webhook
- Spied Pievienot webhook.
- Ieraksti Adresi (jābūt
https://). - Atzīmē Notikumus, kas tavai sistēmai tiešām vajadzīgi.
- Spied Izveidot webhook.
- Atvērsies webhook lapa ar Paraksta atslēgu. Nokopē to uzreiz (poga blakus) — vēlāk to vairs nerādīs.
Izslēgts webhook (Aktīvs noņemts) paliek saglabāts, bet ziņas netiek sūtītas.
Notikumi
Produkti: produkts izveidots, mainīts, arhivēts, publicēts veikalā, pievienots sortimentam, produkti apvienoti / apvienošana atcelta, produkts atsaistīts, variants piesaistīts / atsaistīts mātes produktam.
Attēli un faili: augšupielādēts attēls vai fails, attēli vai faili mainīti.
Teksti un īpašības: tulkošana pabeigta, bagātināšana pabeigta, īpašības apvienotas / apvienošana atcelta.
Piegādātāji: imports pabeigts, piedāvājums vairs nav pieejams, piegādātājs pievienots / atvienots.
Paraksta pārbaude
Katram pieprasījumam ir galvene:
X-Ecompim-Signature: t=<unix laiks>,v1=<paraksts>
v1 = HMAC-SHA256(paraksta atslēga, t + "." + pieprasījuma ķermenis), heksadecimāli. Pārbaudi parakstu un noraidi vecus pieprasījumus (piemēram, ja t ir vecāks par 5 minūtēm).
Paraksta atslēgu PIM izveido automātiski un parāda tikai vienu reizi; vēlāk redzami tikai pēdējie 4 simboli. Ja atslēga pazaudēta vai nonākusi svešās rokās, spied Nomainīt atslēgu un apstiprini — vecā atslēga uzreiz pārstāj darboties, jaunā tiek parādīta vienu reizi. Neaizmirsti to ielikt savā sistēmā.
Ja tava sistēma neatbild
PIM mēģina 4 reizes: uzreiz, pēc 1 minūtes, pēc 5 minūtēm un pēc 30 minūtēm. Pēc tam notikums netiek sūtīts vēlreiz.
Lai neko nepalaistu garām, papildus lieto API galapunktu
/api/v1/events— tajā ir visi notikumi, un to var nolasīt jebkurā brīdī.