Voor developers en AI-agents

Hightower Sites API-documentatie

Hightower Sites bouwt en beheert websites voor zzp en MKB in Nederland. De openbare scanner geeft een technische eerste indruk van één publieke pagina. Deze documentatie beschrijft de bestaande scan-API en het ophalen van Is Agentic-rapporten.

Wanneer gebruik je Hightower Sites?

Gebruik deze site om websiteabonnementen te vergelijken, werk van Marko Rampen te bekijken, een openbare bedrijfswebsite technisch te controleren of contact op te nemen over ontwerp, bouw en beheer. Een geautomatiseerde scan vervangt geen persoonlijke beoordeling. Een opdracht, prijsafspraak of wijziging aan een klantwebsite verloopt via contact met Marko.

Authenticatie en toegang

De twee beschreven endpoints zijn openbaar en vereisen geen account, API-sleutel of OAuth. Er is geen publieke GraphQL-API. De scan-API haalt openbare pagina’s op; privé-netwerken, afwijkende poorten en URL’s met inloggegevens worden geweigerd. Mail- en providergeheimen blijven op de server.

Technische websitescan

POST /api/website-scan.php met Content-Type: application/json. Geef een openbaar HTTP(S)-adres in url. part is core (standaard) of psi; strategy is mobile (standaard) of desktop. refresh is standaard false. Core controleert onder meer HTML, SEO-basis, structured data, HTTPS en beveiligingsheaders; psi gebruikt Google PageSpeed voor prestaties en toegankelijkheid. Beide kunnen parallel worden aangeroepen.

curl -X POST https://hightowersites.nl/api/website-scan.php \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://example.com/","part":"core"}'

Een geslaagd antwoord bevat ok: true en een result met het onderzochte adres, de meetdatum en modules. Een ontbrekende externe meting kan als providerfout in het resultaat staan. De totaalscore beoordeelt de technische eerste indruk van de opgegeven pagina.

Is Agentic-rapport ophalen

GET /api/agent-readiness.php?url=... haalt via de officiële gratis Is Agentic-API het bestaande openbare rapport op. Dit endpoint start geen nieuwe scan. Gebruik een openbaar pagina-adres zonder queryparameters, fragment, inloggegevens of persoonlijke gegevens.

curl 'https://hightowersites.nl/api/agent-readiness.php?url=https%3A%2F%2Fexample.com%2F'

De status result.state is available als er een rapport is, of not_found als een rapport ontbreekt. Een ontbrekend rapport is geen score van nul. De meetdatum staat in scannedAt; de AI-gereedheidsscore staat los van de technische totaalscore. Rapporten worden maximaal vijf minuten hergebruikt. Start een nieuwe scan bij Is Agentic om veranderingen te controleren. De API-koppeling is momenteel gratis, zonder provider-API-sleutel; beschikbaarheid en tarieven kunnen door Is Agentic veranderen.

Foutmeldingen en limieten

API-fouten gebruiken RFC 9457 Problem Details met Content-Type: application/problem+json: type, title, status, detail, instance, code en resolution. De oudere ok en error-velden blijven beschikbaar. Verkeerde methoden geven 405 en een Allow-header; onbekende API-routes geven 404 JSON.

De technische scanner staat 10 nieuwe deelmetingen per IP per 600 seconden toe; core en psi tellen ieder één keer, dus vijf complete scans. Bestaande scannerresultaten blijven 30 minuten gecached. Het Is Agentic-endpoint staat 30 nieuwe rapportaanvragen per IP per 60 seconden toe. Cachehits kosten geen nieuwe meting.

Antwoorden geven RateLimit-Policy en RateLimit volgens de actuele IETF structured-field conventie, plus RateLimit-Limit, RateLimit-Remaining en RateLimit-Reset voor oudere clients. Bijvoorbeeld RateLimit-Policy: "scan";q=10;w=600 en RateLimit: "scan";r=8;t=580. Reset en Retry-After zijn seconden tot hernieuwde capaciteit, geen Unix-timestamp. Bij 429: wacht minstens Retry-After seconden en probeer daarna opnieuw; blijf niet pollen.

Leesbare content en ontdekking

Vraag de homepage of een openbare HTML-pagina op met Accept: text/markdown voor Markdown. Browsers krijgen HTML; beide varianten geven Vary: Accept. q-waarden worden gerespecteerd en uitsluitend ongeschikte formaten geven 406. Ontbrekende pagina’s houden HTTP 404 en geven met Markdown een uitleg en herstel-links.

OpenAPI 3.1.1-specificatie · llms.txt en wanneer-gebruiken-instructies · Volledige leesbare informatie · Sitemap · Over Marko · Privacy