Gå til hovedinnhold
Beta! This documentation is automatically generated. Information may be incomplete or contain errors, especially screenshots and code samples. We'd love your feedback: use the "Did you find what you were looking for?" widget below, the chat in the bottom right, or email support@placepoint.no - we'll get back to you as soon as we can.

Create a subscription

POST 

/subscriptions

Creates a subscription that delivers change events for one property or company as signed CloudEvents 1.0 webhooks. Idempotency-Key replays the same response to a retried request for 24 hours.

Each delivery is a CloudEvents 1.0 envelope: specversion "1.0", a type like "no.placepoint.property.owner_changed", source identifying the subscription, id, time and data holding the changed resource. The request carries a Placepoint-Signature header shaped t=<unix-timestamp>,v1=<hex-signature>, where signature is the hex-encoded HMAC-SHA256, keyed on secret, of the string formed by joining t and the raw request body with a period. The receiver can verify authenticity before trusting the payload. A failed delivery retries with exponential backoff for up to 24 hours; delivery is at-least-once, so a receiver must handle a duplicate event by id.

Produktside: Varsler.

Request

Responses

The created subscription.

Beta! This documentation is automatically generated. Information may be incomplete or contain errors, especially screenshots and code samples. We'd love your feedback: use the "Did you find what you were looking for?" widget below, the chat in the bottom right, or email support@placepoint.no - we'll get back to you as soon as we can.