Webhooks
Ildstedet sends an HTTPS POST to your endpoint when a product in the catalog changes.
What you provide
Endpoint URLHTTPSRequiredA public URL that accepts POST requests with a JSON body. Share it with your Ildstedet contact.
What you receive
A signing secret, shared with you out of band. Store it like a password. You use it to verify every request.
What you implement
- Read the raw request body and the
X-Ildstedet-Webhook-Signatureheader. - Verify the signature before you parse JSON.
- Return a 2xx response quickly. Do heavier work after you have acknowledged the request.
- Upsert by
productNumber. The same product can be delivered more than once.
You do not poll. Once the webhook is active, Ildstedet pushes events to your URL.
Product updates that happen during the day are delivered together, once per day, in batches of 50. See the product webhook.