{"openapi":"3.1.0","info":{"title":"Spaniahus API","version":"1.0.0","description":"Åpent API for boliger til salgs langs Spanias sørøstkyst, formidlet av Blanca International og norske partnere. Ingen nøkkel. Start med /api/kunnskap.","contact":{"email":"post@spaniahus.no","url":"https://www.spaniahus.no/kontakt"}},"servers":[{"url":"https://www.spaniahus.no"}],"paths":{"/api/kunnskap":{"get":{"operationId":"kunnskap","summary":"Hvem vi er, hva vi tilbyr, hvor vi selger, hva et kjøp koster, og hvilke API-er som finnes.","responses":{"200":{"description":"Katalog","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/sok":{"get":{"operationId":"sokBoliger","summary":"Søk i boliger til salgs.","parameters":[{"name":"sted","in":"query","description":"Bynavn slik feeden staver det, f.eks. Javea, Torrevieja, Marbella. Kan gjentas.","schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true},{"name":"region","in":"query","description":"Costa Blanca Nord, Costa Blanca Sør, Costa Cálida, Costa de Almería eller Costa del Sol. Kan gjentas.","schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true},{"name":"type","in":"query","description":"leilighet, villa, rekkehus eller toppleilighet. Kan gjentas.","schema":{"type":"array","items":{"type":"string","enum":["leilighet","villa","rekkehus","toppleilighet"]}},"style":"form","explode":true},{"name":"min","in":"query","description":"Laveste pris i euro.","schema":{"type":"integer"}},{"name":"maks","in":"query","description":"Høyeste pris i euro.","schema":{"type":"integer"}},{"name":"sov","in":"query","description":"Minst så mange soverom.","schema":{"type":"integer"}},{"name":"areal","in":"query","description":"Minst så mange m² boareal.","schema":{"type":"integer"}},{"name":"arealMaks","in":"query","description":"Høyst så mange m² boareal.","schema":{"type":"integer"}},{"name":"nybygg","in":"query","description":"1 for bare nybygg.","schema":{"type":"string","enum":["1"]}},{"name":"basseng","in":"query","description":"1 for bare boliger med basseng.","schema":{"type":"string","enum":["1"]}},{"name":"strand","in":"query","description":"1 for gangavstand til strand eller førstelinje.","schema":{"type":"string","enum":["1"]}},{"name":"sorter","in":"query","description":"anbefalt (standard), pris-lav eller pris-hoy.","schema":{"type":"string","enum":["anbefalt","pris-lav","pris-hoy"]}},{"name":"side","in":"query","description":"Sidetall fra 1.","schema":{"type":"integer","minimum":1}},{"name":"per","in":"query","description":"Treff per side, 1–100.","schema":{"type":"integer","minimum":1,"maximum":100,"default":24}}],"responses":{"200":{"description":"Treff","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer"},"side":{"type":"integer"},"per":{"type":"integer"},"kurs":{"type":"number","description":"NOK per euro"},"boliger":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string","format":"uri"},"tittel":{"type":"string"},"type":{"type":"string","description":"Leilighet, Villa, Rekkehus, Toppleilighet …"},"sted":{"type":"string"},"omrade":{"type":"string"},"region":{"type":"string"},"pris_eur":{"type":["number","null"]},"pris_nok":{"type":["number","null"],"description":"Rundet til nærmeste 10 000."},"soverom":{"type":["integer","null"]},"bad":{"type":["integer","null"]},"boareal_m2":{"type":["number","null"]},"tomt_m2":{"type":["number","null"]},"nybygg":{"type":"boolean"},"basseng":{"type":"boolean"},"sjoutsikt":{"type":"boolean"},"gangavstand_strand":{"type":"boolean"},"bilde":{"type":["string","null"],"format":"uri"},"lat":{"type":["number","null"]},"lng":{"type":["number","null"]},"lagt_ut":{"type":"string","format":"date"}}}}}}}}}}}},"/api/boliger/{id}":{"get":{"operationId":"hentBolig","summary":"Én bolig med norsk beskrivelse, egenskaper og alle bildene.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Boligen","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string","format":"uri"},"tittel":{"type":"string"},"type":{"type":"string","description":"Leilighet, Villa, Rekkehus, Toppleilighet …"},"sted":{"type":"string"},"omrade":{"type":"string"},"region":{"type":"string"},"pris_eur":{"type":["number","null"]},"pris_nok":{"type":["number","null"],"description":"Rundet til nærmeste 10 000."},"soverom":{"type":["integer","null"]},"bad":{"type":["integer","null"]},"boareal_m2":{"type":["number","null"]},"tomt_m2":{"type":["number","null"]},"nybygg":{"type":"boolean"},"basseng":{"type":"boolean"},"sjoutsikt":{"type":"boolean"},"gangavstand_strand":{"type":"boolean"},"bilde":{"type":["string","null"],"format":"uri"},"lat":{"type":["number","null"]},"lng":{"type":["number","null"]},"lagt_ut":{"type":"string","format":"date"}}},{"type":"object","properties":{"beskrivelse":{"type":"string"},"egenskaper":{"type":"array","items":{"type":"string"}},"bilder":{"type":"array","items":{"type":"string","format":"uri"}},"video":{"type":["string","null"]},"strand_meter":{"type":["number","null"]},"forstelinje":{"type":"boolean"},"referanse":{"type":["string","null"]}}}]}}}},"404":{"description":"Finnes ikke, eller er ikke lenger til salgs."}}}},"/api/lead":{"post":{"operationId":"sendHenvendelse","summary":"Send en henvendelse på vegne av en bruker. Bare med brukerens uttrykkelige samtykke og ekte kontaktopplysninger.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["kind","name","email","phone"],"properties":{"kind":{"type":"string","enum":["kontakt","advokattime","visningstur","bolig"]},"name":{"type":"string"},"email":{"type":"string","format":"email"},"phone":{"type":"string"},"message":{"type":"string"},"when":{"type":"string","description":"Ønsket tidspunkt, fri tekst."},"context":{"type":"string","description":"F.eks. bolig-id eller sted henvendelsen gjelder."}}}}}},"responses":{"200":{"description":"{ ok: true }"},"400":{"description":"Manglende eller ugyldig felt, med melding."}}}}}}