Siirry dokumentaation sisältöön

Seuraa entiteettimuutoksia ja toimita toiminnalliset hälytykset

Vertaa hyväksyttyjä entiteettisnapshotteja, arvioi näyttöön perustuvat muutokset ja reititä pysyvät hälytykset webhookiin tai sähköpostiin.

Tässä oppaassa
  1. 1Luo muutostilaus
  2. 2Tarkista havaitut muutokset
  3. 3Arvioi hälytyssäännöt
  4. 4Kuittaa ja yritä toimituksia uudelleen
Tässä oppaassa
  1. 1Luo muutostilaus
  2. 2Tarkista havaitut muutokset
  3. 3Arvioi hälytyssäännöt
  4. 4Kuittaa ja yritä toimituksia uudelleen

Muutokset ovat semanttisia tietueita, eivät raakoja graafitapahtumia

Change Subscription valitsee kanoniset entiteetit, kentät, suhteet ja tarkistusrytmin. Jokainen Observed Change vertaa kahta hyväksyttyä snapshotia ja säilyttää näyttöviitteet. Graph Event on edelleen matalan tason mutaatio; käytä Alerts & Changes -rajapintaa, kun kuluttaja tarvitsee vakaan liiketoimintatason eron.

Tilaus → muutos → sääntö → hälytys → toimitus

Luo tilaus changes:write-oikeudella. Aja se käsin tai anna rytmin käynnistää tarkistus. Käytössä olevat Alert Rulet täsmäävät vakavuuteen, muutostyyppiin, entiteettiin ja kenttään. Täsmäävä muutos luo yhden pysyvän Alertin ja yhden toimituksen jokaista kanavaa kohti, joten toimituksen uudelleenyritys ei monista hälytystä.

Luo seurattava entiteettijoukko

Entiteettitunnisteiden pitää olla valmiiksi kanonisia. Rajaa tilaus kenttiin ja suhteisiin, joilla on todellinen vaikutus jatkopäätökseen.

cURL
curl -X POST https://api.enrich.nordicdevhouse.com/v1/change-subscriptions \
  -H "Authorization: Bearer enrich_live_••••••••" \
  -H "Idempotency-Key: subscription-nordic-accounts-v1" \
  -H "Content-Type: application/json" \
  -d '{"name":"Nordic account watch","entity_ids":["org_fi_2841842_1"],"fields":["employee_count","credit_status"],"cadence":"daily"}'

Reititä vain olennaiset muutokset

Sääntö vaatii näkyvät vakavuudet, muutostyypit ja kanavat. Tyhjä entity_ids tai fields tarkoittaa kaikkia tilattuja entiteettejä tai kenttiä. Webhook-toimitukset käyttävät samoja allekirjoituskontrolleja kuin rikastuswebhookit.

JSON
{"name":"Olennaiset asiakasmuutokset","severities":["high","critical"],"change_types":["field_changed"],"channels":["webhook","email"]}

Käsittele hälytystä erillään toimituksesta

ResurssiTarkoitusOikeudet
Change SubscriptionEntiteetit ja seurantarytmichanges:read / changes:write
Observed ChangeSnapshotien näyttöön perustuva erochanges:read
Alert RuleOlennaisten muutosten ja kanavien täsmäysalerts:read / alerts:write
AlertPysyvä tila ja kuittausalerts:read / alerts:write
Alert DeliveryKanavakohtainen yritys ja retryalerts:read / alerts:write

Tuotannon tarkistuslista

Jokainen kirjoitus vaatii pyyntökohtaisen Idempotency-Key-avaimen. Toimitustyöntekijä allekirjoittaa webhook-rungon, estää uudelleenohjaukset ja yksityiset osoitteet sekä siirtää loppuun käytetyt yritykset dead-letter-tilaan. Määritä entiteettitunnistin, toimitusosoitteet, vähintään 32 merkin allekirjoitussalaisuus, sallittujen hostien lista ja worker-salaisuus ennen ajastusten käyttöönottoa. Oletussäilytys on 90 päivää.

KontrolliVaatimus
Kanoninen identiteettiTilaa vain vakaita Entity Intelligence -tunnisteita
NäyttöSäilytä change_id ja evidence_refs jatkopäätöksen yhteydessä
IdempotenssiKäytä avainta uudelleen vain täsmälleen samalle pyynnölle; alert.id on pysyvä deduplikointiavain
UudelleenyritysYritä toimitusresurssia uudelleen, älä luo Alertia uudelleen
OikeudetVaadi sekä operaation scope että tuotteen entitlement
OperointiAja tarkistukset, toimitusjono, säilytys, metriikat ja auditointi autentikoidulla workerilla
Oliko tästä sivusta apua?