Skip to content
Apier

For plattformer · Årsregnskapsovervåking

Webhook-klar accounts.updated-overvåking

Jobben

Du vil at plattformen din skal trigge arbeid i det øyeblikket en klient leverer nytt årsregnskap — uten å polle hver dag.

Endepunkt

  • POST /api/v1/subscriptions

Forespørsel

curl -X POST https://www.apier.no/api/v1/subscriptions \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"webhook_url":"https://example.com/hooks/apier","filter":{"source":"brreg","entity_type":"annual_accounts"}}'

Levert webhook-nyttelast (POST til ditt endepunkt)

{
  "subscription_id": "3f1a0c4e-0000-4000-8000-000000000001",
  "delivered_at": "2026-06-15T10:00:03Z",
  "attempt_number": 1,
  "correlation_id": "8c2d6b7a-0000-4000-8000-000000000002",
  "change": {
    "id": "a17b9d3c-0000-4000-8000-000000000003",
    "source": "brreg",
    "entity_type": "annual_accounts",
    "entity_id": "999999999",
    "change_type": "updated",
    "field_path": "/last_accounts_year",
    "before_value": {
      "last_accounts_year": 2023
    },
    "after_value": {
      "last_accounts_year": 2024
    },
    "detected_at": "2026-06-15T10:00:02Z"
  }
}

Apier POSTer dette til webhook_url-en din med en HMAC-SHA256-signatur i x-apier-signature. Leveringen er minst-én-gang: gjør mottakeren idempotent ved å nøkle sideeffekter på change.id.

Neste steg

  • Verifiser signaturen før du stoler på en levering (se Webhooks-guiden for kodeeksempel).
  • Les den gjeldende statusen når som helst med GET /api/v1/company/{org}/accounts.