Aviseringar: Få besked med detsamma

Skapa, lista och ta bort prenumerationer på ändringar för en fastighet eller ett företag, levererat som signerade CloudEvents-webhooks till en URL som du själv anger.

Logg inn med GitHubSlik ser det ut ↓Teknisk referanse →

Nøkkelen virker på Placepoint API og på dagens Data API, 35 kall om dagen i 14 dager.

Prøv med et ekte bygg: Tordenskiolds gate 2

• Testa på under en minut
• Signerade webhooks
• CloudEvents 1.0
• At-least-once-leverans
• Idempotent skapande

info

Placepoint API är under utveckling. Den här slutpunkten svarar inte ännu, och vi har inget datum för när den gör det.

Från ändring till avisering

Anropen svarar på hur ett system får besked när något faktiskt ändras, i stället för att polla ett objekt på nytt varje timme. Banker som följer upp pantsäkerhet behöver avisering när en ägare eller en inteckning ändras, förvaltare behöver avisering när en ny transaktion registreras på en fastighet i portföljen, och system som övervakar många företag samtidigt slipper hämta varje företag på nytt bara för att upptäcka att inget har hänt.

En prenumeration riktas mot antingen en fastighet eller ett företag och en lista med händelsetyper, till exempel OWNER_CHANGED eller TRANSACTION_REGISTERED. Varje händelse levereras som en signerad CloudEvents 1.0-webhook, och leveransen är at-least-once, så mottagaren måste hantera att samma id kan komma mer än en gång.

• Idempotent skapande

  createSubscription kräver en Idempotency-Key-header, så en retry av samma skapande ger samma svar i 24 timmar i stället för en dubblerad prenumeration.

• Signerat och verifierbart

  Varje webhook bär headern Placepoint-Signature, att verifiera med HMAC innan du litar på innehållet.

• At-least-once, hantera dubbletter

  Ett misslyckat försök upprepas i upp till 24 timmar, så samma id kan komma mer än en gång på mottagarsidan.

Fält som faktiskt säger något

Tre anrop täcker hela livscykeln för en prenumeration, alla med scopet subscription:write.

Skapa en prenumeration.

POST/subscriptions

curl -X POST "https://data.placepoint.no/subscriptions" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"target":{"kind":"PROPERTY","country":"NO","cadastreId":"0301-209-369-0-0"},"events":["OWNER_CHANGED","TRANSACTION_REGISTERED"],"webhookUrl":"https://example.com/webhooks/placepoint","secret":"whsec_REPLACE_WITH_32_RANDOM_CHARS"}'

svar · 201

{
  "id": "sub_9f2c1a",
  "target": {
    "kind": "PROPERTY",
    "country": "NO",
    "cadastreId": "0301-209-369-0-0"
  },
  "events": [
    "OWNER_CHANGED",
    "TRANSACTION_REGISTERED"
  ],
  "webhookUrl": "https://example.com/webhooks/placepoint",
  "status": "ACTIVE",
  "createdAt": "2026-09-07T10:15:00Z"
}

Scope: subscription:writeTeknisk referanse og Try-it

Vis alle felt (9)

Felt	Type	Beskrivelse
id	string	Subscription identifier.
target.kind	string	Resource type the subscription targets.
target.country	string	ISO 3166-1 alpha-2 country code. Present for both target types.
target.cadastreId	string	Cadastre identifier, present for a PROPERTY target.
target.id	string	Register identifier, present for a COMPANY target.
events[]	string[]	Event types delivered to this subscription.
webhookUrl	string	The HTTPS endpoint events are delivered to.
status	string	Subscription status.
createdAt	string	When the subscription was created.

Lista egna prenumerationer

listSubscriptions visar egna aktiva och pausade prenumerationer.

GET/subscriptions

curl -X GET "https://data.placepoint.no/subscriptions" \
  -H "Authorization: Bearer $TOKEN"

svar · 200

{
  "items": [
    {
      "id": "sub_9f2c1a",
      "target": {
        "kind": "PROPERTY",
        "country": "NO",
        "cadastreId": "0301-209-369-0-0"
      },
      "events": [
        "OWNER_CHANGED",
        "TRANSACTION_REGISTERED"
      ],
      "webhookUrl": "https://example.com/webhooks/placepoint",
      "status": "ACTIVE",
      "createdAt": "2026-09-07T10:15:00Z"
    }
  ]
}

Scope: subscription:writeTeknisk referanse og Try-it

Vis alle felt (9)

Felt	Type	Beskrivelse
items[].id	string	Subscription identifier.
items[].target.kind	string	Resource type the subscription targets.
items[].target.country	string	ISO 3166-1 alpha-2 country code. Present for both target types.
items[].target.cadastreId	string	Cadastre identifier, present for a PROPERTY target.
items[].target.id	string	Register identifier, present for a COMPANY target.
items[].events[]	string[]	Event types delivered to this subscription.
items[].webhookUrl	string	The HTTPS endpoint events are delivered to.
items[].status	string	Subscription status.
items[].createdAt	string	When the subscription was created.

Ta bort en prenumeration

deleteSubscription stoppar leveransen omedelbart.

DELETE/subscriptions/{subscriptionId}

curl -X DELETE "https://data.placepoint.no/subscriptions/sub_9f2c1a" \
  -H "Authorization: Bearer $TOKEN"

Scope: subscription:writeTeknisk referanse og Try-it

En levererad händelse ser ut så här:

{
  "specversion": "1.0",
  "type": "no.placepoint.property.owner_changed",
  "source": "https://data.placepoint.no/subscriptions/sub_9f2c1a",
  "id": "evt_4b2a1c",
  "time": "2026-09-07T10:15:00Z",
  "datacontenttype": "application/json",
  "data": {
    "country": "NO",
    "cadastreId": "0301-208-15-0-0",
    "changedField": "owners"
  }
}

Verifiera signaturen i headern Placepoint-Signature: t=<unix>,v1=<hex> innan du litar på innehållet:

const crypto = require("node:crypto");

function isValid(header, rawBody, secret) {
  const [t, v1] = header.split(",").map((p) => p.split("=")[1]);
  const expected = crypto
    .createHmac("sha256", secret)
    .update(`${t}.${rawBody}`)
    .digest("hex");
  return crypto.timingSafeEqual(Buffer.from(v1), Buffer.from(expected));
}

Testa på under en minut

1. Logga in med GitHub

   Ett klick, under en minut, inget betalkort. Nyckeln kommer tillbaka till den här sidan.

2. Anropa slutpunkten

   Curl-anropet ovan fylls i med din nyckel när du är inloggad. createSubscription behöver mål (fastighet eller företag), händelsetyper och en Idempotency-Key.

3. Verkställ svaret

   Verifiera signaturen i Placepoint-Signature med din hemlighet innan du litar på innehållet, med funktionen i exemplet ovan.

Data och källor

Aviseringarna utlöses av samma ändringar som resten av API:et exponerar: ägarbyte, ny transaktion och motsvarande händelser på fastigheten eller företaget som prenumerationen gäller.

Se även

• Utvecklarguiden
• Projekt
• Taggar
• Teknisk referens
• Placepoint API

Frågor och svar

Vad händer om jag skickar samma skapande två gånger?

Idempotency-Key-headern gör en retry säker: samma nyckel inom 24 timmar ger samma svar tillbaka i stället för en ny prenumeration.

Kan samma händelse komma flera gånger?

Ja. Leveransen är at-least-once, och ett misslyckat försök upprepas med ökande mellanrum i upp till 24 timmar. Mottagaren måste hantera att samma id kan komma mer än en gång.

Hur verifierar jag att en webhook faktiskt kommer från Placepoint?

Headern Placepoint-Signature: t=<unix>,v1=<hex> bär en HMAC-signatur över tidsstämpel och body. Räkna ut samma HMAC med din hemlighet och jämför, som i exemplet ovan.

Vilka händelsetyper kan jag prenumerera på?

OWNER_CHANGED och TRANSACTION_REGISTERED är kärnan, med fler händelsetyper på fastighet och företag efter hand som API:et byggs ut.

Slut på polling, låt ändringen hitta dig

Tre anrop täcker hela livscykeln, med signerade och verifierbara webhooks. Logga in med GitHub högst upp på sidan för att prova det i dag, eller ta kontakt för tillgång till hela landet.

Logg inn med GitHub