Setja upp vefkrók

Vefkrókar láta kerfin ykkar vita af atburðum um leið og þeir gerast, til dæmis þegar viðtakandi staðfestir móttöku. Parasend kallar á slóðina ykkar með undirritaðri, þunnri tilkynningu sem inniheldur engar persónuupplýsingar: aðeins tegund atburðar og auðkenni. Kerfið ykkar sækir svo nánari upplýsingar með API-lyklinum sínum.

Hverjir geta gert þetta: meðlimir með heimildina API-lyklar og vefkrókar sem sjá allar sendingar teymisins. Vefkrókar í prófunargögnum fá aðeins atburði prófunarsendinga.

Vefkrókar: svona virkar vefkrókur, og listinn yfir vefkróka

Stofna vefkrók

  1. Opnaðu Vefkrókar og smelltu á + Nýr vefkrókur.
  2. Sláðu inn Slóð. Hún þarf að vera https á porti 443, á léni á opna netinu. Parasend athugar slóðina þegar þú vistar og við hverja tengingu.
  3. Ef þú vilt geturðu fyllt út reitinn Lýsing, til dæmis „bókhaldskerfi“.
  4. Undir Atburðir velur þú Allir atburðir (líka þeir sem bætast við síðar) eða Velja atburði.
  5. Undir Uppruni velur þú Allar sendingar, eða Aðeins frá völdum API-lyklum til að fá aðeins atburði sendinga sem eru sendar með þeim lyklum. Þetta kemur sér vel þegar fleiri en eitt kerfi deila einum aðgangi.
  6. Undir Auðkenning hjá móttakanda velur þú Engin, Fastur lykill (Bearer) eða OAuth 2.0. Sjá Auðkenning vefkróka. Nýr vefkrókur: slóð, atburðir, uppruni og auðkenning
  7. Smelltu á Stofna vefkrók og afritaðu undirritunarlykilinn. Hann birtist aðeins einu sinni.

Svara og sannreyna

  • Svaraðu með hvaða 2xx-stöðu sem er innan 10 sekúndna. Allt annað, líka áframvísun, telst misheppnuð tilraun. Vistaðu atburðinn og vinndu úr honum í bakgrunni.
  • Athugaðu hausinn Parasend-Signature í hverri beiðni: t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>">, með undirritunarlykilinn ykkar sem lykil. Hafnaðu beiðnum þar sem t víkur meira en 5 mínútur frá klukkunni ykkar.
  • Atburðir geta borist oftar en einu sinni og í annarri röð en þeir gerðust. Notaðu auðkenni atburðarins til að sleppa tvítekningum.

Kóðadæmi fyrir Node.js og Python eru í API-leiðbeiningunum.

Sjá um vefkrók

Í listanum notar þú Breyta, Endurnýja lykil (nýr undirritunarlykill), Gera hlé eða Eyða. Listinn sýnir stöðu hvers vefkróks, síðustu tilraun og villur.

Svaraði þetta spurningunni þinni? Takk fyrir ábendinguna Ekki tókst að senda ábendinguna. Reyndu aftur síðar.