# Hogia API Integration

## Översikt
Detta API används för att integrera med Hogia's fastighetssystem och hämta information om byggnader och trapphus.
API URL: https://publicapilandlord.dinhyresvard.se/swagger/index.html

### Inloggningsuppgifter
Kunduppgifter (username/password per companyid) lagras i tabellen hogia_customers
i api_castit_db. Hanteras via dashboarden.

Acasa Bostad (companyid 205) seedas automatiskt vid första körning.

## Autentisering
API:et använder token-baserad autentisering.
Varje företag har sina egna inloggningsuppgifter.

Frontend-gränssnittet kan testas på app.dinhyresvard.se med samma inloggningsuppgifter.

## Dashboard
### /hogia/hogia-dashboard.php
- Lägg till / redigera / ta bort kunder
- Hämta byggnader per kund
- Visa trapphus-/lägenhetsdata för en byggnad

## Tillgängliga endpoints

### /getbuildings.php
Hämtar lista över alla byggnader
- Parametrar: companyid, hash (access_hash från kunden)

### /getdata.php
Hämtar information om trapphus för en specifik byggnad
- Parametrar:
  - companyid
  - hash (access_hash från kunden)
  - id (byggnads-ID / entrance-id)
- XML per lägenhet: adress, trapphus, lagenhetsnummer, vaning, hyresgast

Utan giltig hash returneras HTTP 403.
Hash syns i Hogia-dashboarden och kan förnyas där.

### /hogia-register.php
Registrerar/uppdaterar kund från Castit (username/password).
- POST: company_id, username, password, name?
- Auth: X-CASTIT-HOGIA-TOKEN, localhost, eller API-dashboard-inloggning
- Verifierar inloggning mot Hogia innan sparning
- Returnerar access_hash

### /hogia-tenants.php
JSON för Castit: hyresgäster per adress
- Parametrar: company_id, hash, address

## Felhantering
- API:et returnerar HTTP-statuskoder för att indikera resultat
- Curl-fel och felaktiga HTTP-svar loggas
- Alla anrop kräver giltig token

## Databasanslutning
API:et använder olika databasanslutningar beroende på server:
- Lokal utveckling (127.0.0.3)
- Produktionsserver (46.21.107.47)