Yksi julkaistu sopimus
Ladattava OpenAPI-dokumentti on entiteettien tunnistuksen, rikastustöiden, tietuetulosten, graafikyselyiden, näytön, tarkistuspäätösten ja tulosartifaktien totuuden lähde.
Synkroninen tunnistus, asynkroninen rikastus
POST /entity-resolution/resolve palauttaa yhden identiteettipäätöksen heti. POST /enrichment-jobs vastaanottaa kestävän erän, käyttää samaa tunnistusmallia, rikastaa hyväksytyt faktat ja palauttaa asynkronista käsittelyä varten 202-vastauksen.
Asynkronisen työn tilat
Onnistunut lähetys palauttaa 202-vastauksen ja Location-otsakkeen. Pollaa kestävää työtä, kunnes se valmistuu, epäonnistuu tai perutaan. Valmiilla työllä voi silti olla tarkistustapauksia.
Turvalliset uudelleenyritykset
Käytä yhtä Idempotency-Key-arvoa yhdelle täsmälliselle erälle. Sama pyyntö palauttaa alkuperäisen työn; avaimen käyttö eri tietueille palauttaa 409.
Tuoreus ja lähderistiriidat pysyvät näkyvinä
Jokainen hyväksytty fakta sisältää observed_at- ja freshness-tiedot. Kun sallitut lähteet ovat eri mieltä, tila on conflicted ja observations säilyttää jokaisen tarjoaja-arvon, luottamustason, varmuuden ja valintatilan. Lähdepolitiikka voi rajata tarjoajat, lisenssit, kustannustasot tai luottamustasot ennen valintaa.
Tuotantorealistiset feikkiskenaariot
| X-Fake-Scenario | Toiminta |
|---|---|
| async-job | queued → processing → completed työn lukukerroilla |
| source-conflict | Säilyttää authoritative- ja curated-lähteiden ristiriitaiset havainnot |
| partial-failure | Valmistaa erän yhden tietueen retryable-virheestä huolimatta |
| webhook-retry | Tallentaa 503-toimituksen ja deterministisen seuraavan yrityksen |
| server-error-once | Palauttaa yhden retryable 503:n ja onnistuu seuraavalla |
| rate-limited | Palauttaa 429:n Retry-After- ja reset-otsakkeilla |
| slow | Lisää rajatun deterministisen viiveen |