Migratiehandleiding: v1 → v2

Deze pagina geeft een overzicht van de wijzigingen die nodig zijn bij de migratie van v1 naar v2 van de API.

1. Wijzigingen in de request body

v1

{
    "post_code": "2771DS",
    "house_number": "87",
    "house_addition": ""
}

v2

{
    "postcode": "2771DS",
    "housenumber": "87",
    "houseaddition": ""
}

2. Wijzigingen in de invoer

a. Basiskenmerken

Nieuwe invoervelden

• roof_type

• electric_cooking

• cooling

Hernoemde invoervelden

• roof_insulation → sloped_roof_insulation

• roof_insulation → flat_roof_insulation

Wijzigingen in de invoer voor zonnepanelen

De structuur van solar_panels is gewijzigd van één integerwaarde naar een lijst waarin afzonderlijke zonnepaneelinstallaties worden beschreven.

Nieuwe velden voor zonnepanelen zijn onder andere:

• solar_panels (per zonnepaneel)

• pv_total_watt_peak

• pv_area

• specific_watt_peak

• angle

• orientation

• roof_type

3. Wijzigingen in de output

De responsstructuur bevat nu extra velden en aangepaste naamgeving.

Hernoemde outputvelden

• roof_insulation → sloped_roof_insulation

• roof_insulation → flat_roof_insulation

Nieuwe outputvelden

• cooling

• electric_cooking

• solar_panels (per zonnepaneel)

• roof_surface

• roof_type

• original_watt_peak_capacity

• total_watt_peak_capacity

• inclination_angle

• orientation

4. Wijzigingen in waarden van kenmerken

Het waardebereik voor verschillende kenmerken is gewijzigd.

Voorheen liepen deze waarden van 0–3, maar nu lopen ze van 1–4.

Dit geldt voor onder andere:

• wall_insulation

• floor_insulation

• flat_roof_insulation

• sloped_roof_insulation

• living_room_windows

• bedroom_windows

Voorbeeld

v1

1 = matige gevelisolatie

v2

2 = matige gevelisolatie