API-documentatie voor HostDirect.

Begin met één openbare aanvraag

De API is gratis te lezen zonder account, sleutel of aanmelding. Een GET-aanvraag geeft JSON met providers en pages. Selecteer daarna lokaal de gewenste aanbieder of categorie. Er zijn geen verplichte parameters en geen request body.

Open het echte API-antwoord · Lees de instructies voor AI-agenten

curl --fail --show-error -H "Accept: application/json" https://hostdirect.nl/api/catalog

Voorbeeld voor JavaScript:

const response = await fetch("https://hostdirect.nl/site.json");
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const catalog = await response.json();
console.log(catalog.counts);
const hosting = catalog.providers.filter(p => p.category === "webhosting");

/site.json bevat dezelfde gegevens en ondersteunt lezen vanaf andere websites. generatedAt kan per aanvraag verschillen. De OpenAPI-specificatie beschrijft alle velden, datatypen, onbekende waarden en foutantwoorden.

Een antwoord verantwoord gebruiken

1. Selecteer het juiste producttype en lees de pakketnaam en beperkingen.
2. Lees price.status, price.checked en de officiële bronnen voordat je een bedrag noemt.
3. Noem historische prijzen als eerder prijspeil. Houd onbekende kosten apart en controleer het definitieve aanbod bij de aanbieder.
4. Verwijs naar het aanbiedersprofiel en de bron bij je vergelijking. Bestellen gebeurt bij de aanbieder.

Fouten en opnieuw proberen

De aanbevolen API is GET /api/catalog; /api geeft dezelfde catalogus. De bestaande WordPress-route blijft beschikbaar. Binnen /api geven onbekende routes 404 (hd_not_found), schrijfpogingen 405 (hd_method_not_allowed) en afgevangen tijdelijke fouten 503 (hd_unavailable). Deze antwoorden zijn JSON met code, message en data.status. De oorspronkelijke WordPress-route behoudt zijn eigen foutcodes.

Een onbekende REST-route of niet-ondersteunde methode geeft normaal 404 met code, message en data.status. Een uitgeschakelde openbare export geeft hd_not_public. Controleer adres en methode; opnieuw proberen zonder wijziging helpt dan niet. Een geldig antwoord kan lege lijsten bevatten.

Controleer altijd de HTTP-status vóór het lezen als JSON. Een infrastructuurfout kan HTML of een lege body geven. Respecteer bij 429 een eventuele Retry-After-header. Probeer een tijdelijke 5xx-fout hoogstens twee keer opnieuw, bijvoorbeeld na 2 en 5 seconden. GET en HEAD wijzigen geen gegevens; er is geen idempotentiesleutel nodig. REST en MCP delen maximaal 120 aanvragen per verbindings-IP per minuut. Lees RateLimit-Remaining en RateLimit-Reset; respecteer Retry-After bij 429. Er is geen beschikbaarheidsgarantie.

Wanneer gebruik je HostDirect?

Vergelijk bijvoorbeeld Cloud86 en mijn.host, zoek een afzonderlijk e-mailpakket of onderzoek waar primaire opslag en back-ups staan. Gebruik altijd de oorspronkelijke prijsstatus en brondata. HostDirect is een redactionele vergelijkingssite met een gerichte selectie; geen hostingbedrijf of volledige marktvergelijking.

Redactie en werkwijze · Verdienmodel · Contact en correcties

Resultaten in delen ophalen

Zonder parameters blijft de API de volledige catalogus geven. Gebruik bijvoorbeeld ?limit=10&offset=0 voor maximaal tien aanbieders en tien pagina's per antwoord. Volg pagination.next totdat die null is, ook als een van de twee lijsten al leeg is. counts bevat de volledige aantallen. De limiet is 1–100; alleen een offset meegeven gebruikt limiet 50. Aanbieders staan op naam, pagina's op ID. De gegevens kunnen tussen aanvragen veranderen; gebruik de volledige export voor één compleet overzicht.

Voorspelbare fouten

Fouten gebruiken application/problem+json met type, title, status en detail. De bestaande velden blijven behouden: de catalogus-API geeft bij toepassingsfouten altijd code, message, data.status, data.retryable, data.retryAfterSeconds en een documentatielink. Ongeldige paginering geeft 400; een onbekende route 404; een schrijfpoging 405. Corrigeer deze aanvragen voordat je opnieuw probeert. Bij tijdelijke toepassingsfouten met status 503 staat Retry-After: 5: wacht minstens vijf seconden en probeer hooguit tweemaal opnieuw. Een storing vóór WordPress kan nog HTML of een leeg antwoord geven; controleer daarom altijd status en inhoudstype.

Geen account of sleutel nodig. Alle catalogusaanvragen lezen uitsluitend openbare informatie en zijn veilig te herhalen.

Python SDK en CLI

Gebruik de kleine HostDirect-client in Python 3.9 of hoger. Er zijn geen extra pakketten, account of sleutel nodig. De SDK en opdrachtregeltool lezen dezelfde openbare API; zoekwoorden en filters worden lokaal toegepast. Alle antwoorden blijven JSON met oorspronkelijke prijsstatus, brondata en beperkingen.

Download Python SDK en CLI (wheel) · Bekijk de volledige Python-broncode

python -m pip install hostdirect-client==1.0.1
python -m hostdirect_client search --category webhosting
python -m hostdirect_client provider cloud86
python -m hostdirect_client compare cloud86 mijnhost

Na installatie is ook het commando hostdirect beschikbaar. Gebruik --help voor de opties. SDK-voorbeeld:

from hostdirect_client import Client, HostDirectError
client = Client(timeout=20)
result = client.compare(["cloud86", "mijnhost"])
print(result["providers"])

Client.catalog(), search(), provider() en compare() wijzigen geen gegevens. Een fout geeft HostDirectError met status en foutcode waar beschikbaar; de CLI geeft een fout als JSON en stopt met exitcode 1. Er zijn geen automatische herhaalpogingen. Respecteer een tijdelijke storing en voorkom snelle herhaallussen.

Versie 1.0.1. Gepubliceerd door HostDirect op PyPI als hostdirect-client. Ook rechtstreeks te downloaden. SHA-256: 0888c03629c1476e789c09fb777771b3f8770763ba26d9e24916894aaddb24b6.

Overzicht voor AI-agents (ARD) · Wanneer en hoe HostDirect gebruiken (skill)

Koppel een AI-agent via MCP

Gepubliceerd in het officiële MCP-register als nl.hostdirect/public-catalogue. De vermelding is gekoppeld aan het domein HostDirect.nl.

Browsers met WebMCP-ondersteuning kunnen dezelfde drie leesfuncties ook rechtstreeks op de gewone website ontdekken. Zonder die ondersteuning blijft de website normaal werken. De korte vergelijkingsskill beschrijft geschikte vragen en bronregels.

Gebruik https://hostdirect.nl/mcp als remote MCP-server met Streamable HTTP. Geen account, sleutel of betaling nodig. De koppeling leest uitsluitend dezelfde openbare catalogus; er zijn geen aankoop-, beheer- of schrijfacties.

• search_providers: zoek op aanbieder, pakket of categorie.
• get_provider: lees één aanbieder met prijsstatus, locatiebewijs en bronnen.
• compare_providers: vraag twee tot zes profielen samen op om ze te vergelijken.

Ondersteunde protocolversies: 2025-03-26, 2025-06-18 en 2025-11-25. Begin met initialize, verstuur daarna notifications/initialized en gebruik tools/list en tools/call. Verzoeken gaan als JSON-RPC via POST met Content-Type: application/json en Accept: application/json, text/event-stream. Stuur na initialisatie de gekozen versie in MCP-Protocol-Version.

De server werkt zonder sessieopslag en antwoordt direct met JSON. Een gewone browser-GET geeft bewust 405: er is geen afzonderlijke gebeurtenissenstroom. Alle zoekresultaten staan in één antwoord, zonder vervolgpagina. De aanvraaglimiet is 32 KiB. Ongeldige argumenten geven een toolfout; protocolfouten hebben een JSON-RPC-code. Behoud bij gebruik altijd de oorspronkelijke prijsstatus, controledatums en bronnen.

Bekijk de openbare MCP-ontdekking en functies. Serverclients zonder Origin-header worden ondersteund. Browseraanvragen met een Origin-header zijn beperkt tot HostDirect zelf; gebruik voor andere clients de openbare JSON-API of een serverkoppeling. Ondersteuning hangt af van de gekozen AI-client.