📖 Finnting API

REST + JSON. Push hele porteføljen din automatisk.

Autentisering

Lag et token i bedriftssenteret og send det som Bearer-token. Tokenet avgjør hvilken bedrift annonsene knyttes til.

Authorization: Bearer ft_live_…

Endepunkter

`PUT`	`/api/v1/listings/{external_id}` — opprett/oppdater (upsert). Dedupe på (bedrift, external_id).
`GET`	`/api/v1/listings` — list bedriftens annonser (filtre: `vertical`, `status`, `limit`, `offset`).
`GET`	`/api/v1/listings/{external_id}` — hent én annonse.
`DELETE`	`/api/v1/listings/{external_id}` — trekk tilbake (status = withdrawn).
`POST`	`/api/v1/listings/{external_id}/sold` — marker som solgt.

external_id er din egen ID for objektet (analogt med IADIF ORDERNO). Den er unik per bedrift, så to bedrifter kan begge bruke «123» uten konflikt. Svaret returnerer Finntings id og offentlig URL.

Eksempel — upsert en bil

curl -X PUT https://finnting.no/api/v1/listings/DLR-7781 \
  -H "Authorization: Bearer ft_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "vertical": "car",
    "title": "Volvo XC60 B4 AWD Inscription",
    "description": "Velholdt, full servicehistorikk.",
    "price": 459000,
    "location": "Stavanger",
    "attrs": {
      "make": "Volvo", "model": "XC60", "year": 2021,
      "km": 58000, "fuel": "Hybrid", "gearbox": "Automat",
      "power": 197, "body": "SUV", "color": "Sort"
    }
  }'

Verticals: car · property · boat · generic. Attributtnøklene er de samme som i Finnting-skjemaet for hver vertikal.

Svar

{
  "operation": "created",
  "id": 4821,
  "external_id": "DLR-7781",
  "vertical": "car",
  "status": "active",
  "org_id": 12,
  "url": "https://finnting.no/annonse/4821/volvo-xc60-b4-awd-inscription",
  "warnings": []
}