API verbeteringen: maart ’25

Er zijn weer een hoop verbeteringen doorgevoerd in de Hosting.NL API. Zwaartepunt bij deze release was het verbeteren van de fundering van de API en het afhandelen van fouten en validatie. Verder zijn er drie (!) nieuwe endpoints toegevoegd!

Vooruitkijkend naar de volgende release

In de volgende release zal de focus liggen op het SSL endpoint. Om voor te sorteren op de kortere geldigheid van SSL certificaten maken we het mogelijk om SSL certificaat bestanden middels een API-call te downloaden. Vervolgens kunnen klanten dit gebruiken om de installatie van SSL certificaten te automatiseren.

Dit zijn de verbeteringen in deze release

Nieuw endpoint voor de controle van de geldigheid van een API-sleutel

Je kunt vanaf nu via GET /permissions controleren of een API-sleutel de juiste rechten heeft.

Nieuw endpoint voor DNS-zone logboek

Met het nieuwe DNS-zone logboek heb je een geschiedenisboek tot je beschikking waarin alle aanpassingen in DNS-zones bijgehouden worden. Zo kan je terugzoeken wanneer een bepaalde wijziging gedaan is of wat de inhoud van een bepaald DNS-record was. Lees er hier meer over.

Nieuw endpoint voor API-logboek

Met dit nieuwe endpoint kan je het API-logboek raadplegen. Zo weet je precies wanneer iets gebeurd is. Lees er hier meer over.

Verbeterde foutmeldingen

Alle endpoints zijn voorzien van meldingen waar je daadwerkelijk iets mee kan. Het generieke “Something went wrong” is vanaf nu als het goed is niet meer het meest gegeven antwoord 🥹.

Verbeterde invoer validatie voor “/domains”-endpoint

Voor /domains/register , transfer en available is de validatie voor domeinnaam en tld verbeterd.

GET “/domains/{domain}”-endpoint uitgebreid

Vanaf nu is uitgebreide status informatie beschikbaar, waar dat van toepassing is. Zo kan je beter achterhalen wat er met een domeinnaam aan de hand is. Een paar voorbeelden:

        "message": "Incorrect authorization code",
        "message": "The properties 'AppPurpose' and 'NexusCategory' are mandatory (registrant:abc_1a2b3c4d)",
        "message": "Transfer is not possible for domains that have been registered in the past 60 days; eligible for transfer on 2025-04-16",

Geforceerde JSON-validatie voor JSON-aanvraag bodies

Hiermee zorgen we ervoor dat alleen geldige en complete gegevens worden geaccepteerd, en alles wat fout is meteen wordt geweigerd. Zo voorkomen we fouten.

Factuurnummer retourneren voor “/invoice”-resultaten

Eerder werd als identificatie alleen een factuurID als resultaat teruggegeven, daar is ons factuurnummer nu aan toegevoegd.