Spring til indhold

Grundfast

Stop overvågning

Fjern en ejendom fra overvågningslisten; der sendes ikke flere hændelser for den.

DELETE/v1/overvaagning/ejendomme/{bfe}

Pladsen frigives med det samme. Tilføjer du ejendommen igen senere, starter den forfra med et nyt udgangspunkt.

Godkendelse · API-nøgle eller session

Virker med en Authorization: Bearer-nøgle eller med din login-session i dashboardet.

Kræver Pro-planen

På en lavere plan svarer endpointet 402. Se planerne.

Afregning

Ikke målt.

Eksempel

curl -X DELETE "https://api.grundfast.dk/v1/overvaagning/ejendomme/5651067" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
Svar · eksempel200
{
  "slettet": true
}

Parametre

bfeintegerstipåkrævet
BFE-nummeret på en ejendom, der er på din overvågningsliste.Eksempel: 5651067

Statuskoder

StatusBetydning
200Svaret er leveret.
400BFE-nummeret er ikke et gyldigt heltal.
401Hverken en gyldig nøgle eller en session.
402Planen er under Pro.
403Nøglen er en admin-nøgle, eller kontoen er suspenderet.
429Burst-grænsen pr. minut er nået.
404BFE-nummeret er ikke på din overvågningsliste.

Alle fejl har samme form. Byg logikken på type (fejlklassen) og vis message (dansk tekst med årsagen) til brugeren; hint kommer med, når vi kan se, hvad der skal rettes, og request_id er det, support skal bruge. Se Fejl og statuskoder for hver type, og hvad der kan prøves igen.

Fejlsvar · 404
{
  "error": "property not found",
  "type": "not_found",
  "code": "not_found",
  "message": "Ressourcen findes ikke.",
  "request_id": "6cbfa45a-a9ea-4140-9d42-ea752a70ff1f",
  "doc_url": "https://grundfast.dk/docs/fejl#not_found"
}

Prøv det

Live-kald fra siden

Kræver din nøgle

Nøglen bliver i denne fane og sendes kun til grundfast.dk. Kaldet tæller som et almindeligt kald — brug en gf_test_-nøgle for at prøve gratis. Opret en gratis nøgle

DELETE /v1/overvaagning/ejendomme/5651067

Bruges ofte sammen med