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 -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.
{"name":"Olennaiset asiakasmuutokset","severities":["high","critical"],"change_types":["field_changed"],"channels":["webhook","email"]}Käsittele hälytystä erillään toimituksesta
| Resurssi | Tarkoitus | Oikeudet |
|---|---|---|
| Change Subscription | Entiteetit ja seurantarytmi | changes:read / changes:write |
| Observed Change | Snapshotien näyttöön perustuva ero | changes:read |
| Alert Rule | Olennaisten muutosten ja kanavien täsmäys | alerts:read / alerts:write |
| Alert | Pysyvä tila ja kuittaus | alerts:read / alerts:write |
| Alert Delivery | Kanavakohtainen yritys ja retry | alerts: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ää.
| Kontrolli | Vaatimus |
|---|---|
| Kanoninen identiteetti | Tilaa vain vakaita Entity Intelligence -tunnisteita |
| Näyttö | Säilytä change_id ja evidence_refs jatkopäätöksen yhteydessä |
| Idempotenssi | Käytä avainta uudelleen vain täsmälleen samalle pyynnölle; alert.id on pysyvä deduplikointiavain |
| Uudelleenyritys | Yritä toimitusresurssia uudelleen, älä luo Alertia uudelleen |
| Oikeudet | Vaadi sekä operaation scope että tuotteen entitlement |
| Operointi | Aja tarkistukset, toimitusjono, säilytys, metriikat ja auditointi autentikoidulla workerilla |