Bonyeza kwenye maudhui

Shughuli za kilimo / kujengwa kwa ajili ya mabadiliko ya baadaye

Waendelezaji

Biashara yako inatoa matukio. Weka URL yoyote unayotaka.

Kila shamba hatimaye anataka kitu ambacho hakuna meli za muuzaji: dashibodi kwenye TV ya ghala, mtawala wa umwagiliaji wa nyumbani ambaye anaitikia tahadhari, script ya taarifa ya kaunti, daraja la programu ambayo hatujawahi kusikia. Jibu la kawaida ni kupiga kura API kwa wakati na kutumaini haukukosa chochote kati ya uchaguzi.

Jibu bora ni mifumo moja ya uzalishaji hutumia na kila mmoja: wakati kitu kinachotokea, kushinikiza, saini, na upya mpaka ardhi.

Jinsi inavyofanya kazi kwa kweli

FarmHubPosts saini JSON kwa URL yoyote ya HTTPS unasanidi, wakati wowote matukio unayojali kuhusu kutokea.

  • Aina sita za matukio, hupigwa kama inavyotokea. Mavuno kumbukumbu, tahadhari alimfufua, tahadhari kutatuliwa, hatua kurekebisha kutatuliwa, kukumbuka kuanzishwa, na ripoti yanayotokana. Kila tukio linaweka mwisho wako kama JSON na jina la tukio katika kichwa.
  • Bei ya hisa ni HMAC-SHA256. FarmHubInazalisha ufunguo wa kutia saini kwa uunganisho na ishara kila mwili wa ombi, kutuma saini katika X-FarmHubIshara ya kichwa. Tumia HMAC juu ya mwili wa mbichi na kulinganisha. Kama si mchezo, basi si kutoka kwetu.
  • Kurudisha kwa backoff. Na kama atarudi kwako au la,FarmHubKuendeleza mwelekeo wa nyuma. Kila moja ya njia hizo ni kwa ajili yako mwenyewe, na kwa ajili ya matumizi yako mwenyewe.
  • Malipo ni versioned, na wewe kudhibiti kuboresha. Wakati sura ya mzigo wa malipo inabadilika, toleo limepigwa, na miunganisho iliyopo inakaa imefungwa kwenye toleo lao hadi unapochagua. Ushirikiano wako haukuvunjika kwa sababu tulisafirisha shamba.

Hii ni moja ya mifumo ya uendeshaji nyuma yetuSlackKwa upande wa timu, naPagerDutyushirikiano, na hatima iliyotolewa na wewe.

Nini unaweza kuweka kwenye akaunti

Nini unaweza kuhesabu

Ulinzi wa uhakika, hasa:

  • FarmHubBonyeza kitufe cha kujiandikisha. Funguo la HMAC linaundwa wakati wa kuunganisha na kuhifadhiwa kwenye uunganisho. Hakuna siri ya pamoja ya kimataifa, na kupokezana ufunguo wa uunganisho huathiri tu uhusiano huo.
  • Viongozi wa kweli wameandaliwa kwa ajili ya maslahi ya kweli. Kila ombi hubeba saini, jina la tukio, na kitambulisho cha pekee cha utoaji, ili uweze kuthibitisha, njia, na deduplicate bila kutumia mwili kwanza.
  • Badilisha. Kuharibu uhusiano mara moja na utoaji kuacha. Tumia wakati wa mwisho wako ni vibaya au unazunguka miundombinu.
  • Hash-chained ukaguzi safu. Kila jaribio la utoaji limerekodiwa katika kumbukumbu ya ukaguzi ambao safu zake zimechained, kwa hivyo historia ya kile kilichotumwa mahali ambapo ni tamper-wazi.

Nini sisi kufanya si

Mipaka ya kweli:

  • Utoaji ni mara moja, sio mara moja. Katika kesi hii, unaweza kuona mara mbili kwa ajili ya mtihani. Kutoa taarifa juu ya uteuzi.
  • Webhooks hufunguliwa tu. Ushirikiano huu haukubali data iliyoingia; inaelezea mifumo yako kilichotokea katikaFarmHub...
  • Aina sita za matukio hapo juu ni nini meli leo. Tungependa kuorodhesha matukio sita halisi kuliko kuahidi orodha ambayo hatujaijenga.

Kuwa mkweli, kuwa mkweli

Unahitaji HTTPS endpoint ambayo inaweza kupokea JSON post.

  1. Ndani yaFarmHubFungua Ushirikiano, chagua Custom Webhook, na uingie URL yako ya mwisho.FarmHubBonyeza kitufe cha usajili cha HMAC.
  2. Katika kesi hiyo, angalia maelezo ya x-FarmHub- Signature header kwa recomputing HMAC-SHA256 juu ya ombi mbichi mwili na ufunguo saini.
  3. Jibu kwa 2xx haraka; fanya usindikaji mkubwa. Majibu yasiyo ya 2xx yanarejeshwa na backoff.
  4. Jaribu utoaji wa mtihani na kuthibitisha uthibitisho wako wa saini hupita kabla ya kutegemea kulisha.

Maswali ambayo wakulima wanauliza

Jinsi ya kuhakikisha kuwa mwenyeji wa wavuti ni kutokaFarmHubya ?

Kulinganisha HMAC-SHA256 juu ya ombi mbichi mwili kutumia kiungo saini na kulinganisha na X-SHA256FarmHubKichwa cha ishara, ambayo hubeba hex digest prefixed na sha256 =. Kukataa kila kitu ambacho hakilingani.

Ni matukio gani ninaweza kujiandikisha?

Mavuno kumbukumbu, tahadhari alimfufua, tahadhari kutatuliwa, hatua kurekebisha kutatuliwa, kukumbuka kuanzishwa, na ripoti yanayotokana. Jina la mchezo huu linaanzia kwenye X-FarmHubya header.

Nini kinatokea ikiwa mstari wangu wa mwisho umeanguka?

FarmHubKurudisha kwa backoff. Kwa sababu utoaji ni mara moja, handler yako lazima deduplicate kutumia X-FarmHubPicha zote na Wizara ya Mambo ya Ndani.

Je, mabadiliko ya bei ya chini yatavunja uhusiano wangu?

Hapana. Malipo ni versioned, na uhusiano wako anakaa pinned na toleo lake payload mpaka wewe kuchagua katika mpya.

Je, ninaweza kubadilisha ufunguo wa kuingia?

Kila uhusiano una yake mwenyeweFarmHubHifadhi ya msingi iliyohifadhiwa encrypted. Kuunganisha masuala mapya muhimu, na swichi ya kuua huacha kujifungua mara moja wakati unazunguka.

kujiandaa kwa ajili ya msimu ujao.

Kujenga kitu ambacho hatukufikiri

Point ya Point PointFarmHub\U2019s saini tukio mkondo katika mwisho wako mwenyewe na waya shamba kwa chochote unaweza kufikiria: dashibodi ya ghala, mtawala, bot ripoti. Haihitaji ruhusa yetu, tu URL.

Kuanza bure