Ejendomsovervågning

Overvågningslisten

Tilføj op til 100 BFE-numre pr. kald. Listen kan administreres med en API-nøgle eller fra dashboardet under Overvågning. En note følger med på alle hændelser for de ejendomme, den blev tilføjet med.

POST /v1/overvaagning/ejendomme
Authorization: Bearer gf_live_...
Content-Type: application/json

{ "bfe": [5651067, 2425322], "note": "Portefølje Nord" }

HTTP/1.1 201 Created

{ "tilfoejet": 2, "allerede_overvaaget": [], "antal": 2, "maks": 250 }

Et kald, der ville bringe listen over planens loft, afvises med 409 og tilføjer ingenting. BFE-numre, der allerede er på listen, tælles ikke og returneres i allerede_overvaaget.

Sådan tjekker vi

Hver ejendom læses cirka én gang i døgnet fra fire registre. Hvert register får sit eget fingeraftryk af de felter, der betyder noget, så en hændelse siger præcis, hvilket register der flyttede sig:

• Det første tjek er et udgangspunkt og sender ingen hændelse. Det kører kort efter, at ejendommen er tilføjet.
• Fingeraftrykket er uafhængigt af rækkefølgen i kildens svar, så samme data altid giver samme aftryk.
• Kan et register ikke læses, bevares det forrige aftryk (status fejl). En kilde, der er nede, udløser derfor aldrig en falsk ændring — næste vellykkede læsning sammenlignes med den sidste gode.
• Svarer et register, at det intet har for ejendommen (status mangler), er det en tilstand i sig selv: dukker en vurdering op, eller forsvinder en bygning, er det en ændring.
• Tidspunkterne spredes over døgnet, så en stor liste ikke tjekkes på én gang. Fejler alle registre, prøves igen efter 1, 2, 4 … timer.
• Opdateringer kan nå os op til et døgn efter, at de er registreret, fordi kilderne selv opdateres løbende og vi læser gennem vores cache.

Se hver ejendoms tilstand med GET /v1/overvaagning/ejendomme/:bfe: registre.bbr.status, hash, opsummering, kontrolleret og aendret pr. register. Selve hændelsen er ejendom.aendret — se payloaden under webhooks.

Adresseændringer

Når den daglige DAR-opdatering lægges ind, sammenligner vi hver berørt adgangsadresse med det, vi havde før, og registrerer en ændring, når den er ny (adresse.oprettet), når betegnelse, vej, husnummer, postnummer, kommune eller placering har ændret sig (adresse.aendret), eller når den er nedlagt eller henlagt (adresse.nedlagt). Ændringer, der ikke rører de felter, giver ingen hændelse.

• En ændring hører til området, adressen ligger i efter ændringen; en nedlagt adresse hører til der, hvor den lå. Vil du følge en bestemt adresse uanset hvor den flytter hen, så angiv dens id.
• Ændringer gemmes i 35 dage.
• Få dem som webhooks i bundter på op til 100 ved at abonnere med et adresseFilter — se Adressehændelser i bundter — eller hent dem selv fra feedet.

GET /v1/overvaagning/adresser/haendelser?kommunekode=0101&efter=0&antal=100
Authorization: Bearer gf_live_...

HTTP/1.1 200 OK

{
  "antal": 100,
  "haendelser": [ { "sekvens": 48112, "haendelse": "adresse.oprettet", ... }, ... ],
  "naeste_efter": 48311,
  "flere": true,
  "meta": { ... }
}

Angiv mindst én af kommunekode, postnr eller adgangsadresse_id (kommaseparerede lister er tilladt). Gem naeste_efter, og send den som efter i næste kald: så springer du aldrig en ændring over og får aldrig den samme to gange. Er flere true, ligger der allerede flere ændringer klar — kald igen med det samme.

import { GrundfastClient } from '@grundfast/sdk';

const gf = new GrundfastClient({ apiKey: process.env.GRUNDFAST_API_KEY! });

let efter = Number(await loadCursor()); // din egen gemte position, 0 første gang
for await (const h of gf.iterateAdresseHaendelser({ kommunekode: ['0101'], efter })) {
  await handle(h);
  efter = h.sekvens;
}
await saveCursor(efter);