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 i dag på Leietaker-API og dagens Data API; Placepoint API godtar samme nøkkel når det lanseres.

Prøv med et ekte bygg: Oslo S, Jernbanetorget 1

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

ℹ️ Slutpunkten svarar när Placepoint API är lanserat. Kontraktet nedan är slutgiltigt, Hyresgäst-API svarar redan.

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 subscriptions.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-207-76-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-207-76-0-0"
  },
  "events": [
    "OWNER_CHANGED",
    "TRANSACTION_REGISTERED"
  ],
  "webhookUrl": "https://example.com/webhooks/placepoint",
  "status": "ACTIVE",
  "createdAt": "2026-09-07T10:15:00Z"
}

Scope: subscriptions.writeTeknisk referanse og Try-it

Vis alle felt (10)

Felt	Type	Beskrivelse
id	string	Subscription identifier.
target.kind	string	Resource type the subscription targets.
target.country	string	ISO 3166-1 alpha-2, present for a PROPERTY target.
target.cadastreId	string	Cadastre identifier, present for a PROPERTY target.
target.scheme	string	ISO 6523 ICD code, present for a COMPANY 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-207-76-0-0"
      },
      "events": [
        "OWNER_CHANGED",
        "TRANSACTION_REGISTERED"
      ],
      "webhookUrl": "https://example.com/webhooks/placepoint",
      "status": "ACTIVE",
      "createdAt": "2026-09-07T10:15:00Z"
    }
  ]
}

Scope: subscriptions.writeTeknisk referanse og Try-it

Vis alle felt (10)

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, present for a PROPERTY target.
items[].target.cadastreId	string	Cadastre identifier, present for a PROPERTY target.
items[].target.scheme	string	ISO 6523 ICD code, present for a COMPANY 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: subscriptions.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));
}

Tre steg till första svaret

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
• 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