Naar de inhoud

Je scans in je eigen software

Elke scan heeft een pand, een verdieping en de m². Met de API haal je ze op als JSON, met een sleutel uit je portaal. Het hoort bij elk account.

Je scans ophalen in je eigen systemen, met één API

Zoek een adres en zie wat de app ophaalt

Rechtstreeks vanuit je browser uit de open registers van het Kadaster. Er gaat niets naar Maximilius en er wordt niets bewaard.

Buitenmuur voor het BVO, per bouwjaar

  1. t/m 1919 220 mm
  2. 1920–1974 280 mm
  3. 1975–1991 300 mm
  4. 1992–2011 340 mm
  5. 2012–2020 380 mm
  6. vanaf 2021 420 mm
  7. onbekend 300 mm

De scan meet de binnenkant. Voor het BVO telt de app er de buitenmuur bij die bij het bouwjaar hoort.

  • GET /v1/health Of de API draait. Zonder sleutel.
  • GET /v1/captures Je opnamen, nieuwste eerst. Filter op pand, project, tag of datum.
  • GET /v1/captures/{id} Eén opname met pand, verdieping, m² en de ruimten.
  • PATCH /v1/captures/{id} Naam, omschrijving, tags of je eigen kenmerk wijzigen.
  • GET /v1/captures/{id}/export Een downloadlink per bestand: DXF, SVG, PDF, PNG, CSV, JSON en USDZ. Eén uur geldig.
  • GET /v1/projects Je panden, elk met zijn opnamen.
  • GET /v1/projects/{id} Eén pand met al zijn verdiepingen en delen.

Voorbeeld

# SCAN_API=https://…/functions/v1/scan-api
# SCAN_API_KEY=scan_…   (je eigen sleutel, nooit delen)

curl "$SCAN_API/v1/captures?limit=1" \
  -H "Authorization: Bearer $SCAN_API_KEY"

Antwoord, ingekort

{
  "captures": [{
    "id": "…",
    "pand": { "adres": "Voorbeeldstraat 12, Den Haag" },
    "verdieping": { "naam": "Verdieping 3", "index": 2 },
    "m2": { "binnenwerks": 59.34, "bruto": 71.24 },
    "processing": { "status": "completed" }
  }]
}

Het adres uit de zoeker hierboven, zoals het in je scan komt te staan

{
  "pand": {
    "adres": null,
    "bagId": null
  },
  "register": {
    "bouwjaar": null,
    "bagOppervlakteM2": null,
    "bronnen": null
  },
  "m2": {
    "binnenwerks": null,
    "bruto": null
  }
}