Versiebeleid

Binnen v5 is elke wijziging een toevoeging:

• nieuwe endpoints;
• nieuwe optionele parameters en velden in een verzoek;
• nieuwe velden in een antwoord;
• nieuwe waarden in een lijst van waarden, zoals een nieuw house_type of een nieuwe fout-code.

Er verdwijnt niets, er wordt niets hernoemd, verplicht of strenger. Code die vandaag werkt, blijft werken, zolang hij velden negeert die hij niet kent en waarden accepteert die hij nog niet zag.

Een wijziging die dat breekt, komt alleen in een nieuwe hoofdversie (v6). Die kondigen we minstens 60 dagen vooraf aan, per e-mail en in de wijzigingen (API-voorwaarden, art. 11.2). v5 blijft daarnaast draaien, zo lang als we daar noemen.