Geekie API-documentatie

Websitecheck: POST /api/website-check

Laat Google PageSpeed Insights een mobiele Lighthouse-meting doen van een openbare website en krijg de vier scores terug (0 tot 100). Een meting duurt tot een minuut. Per IP-adres: 4 metingen per 10 minuten en 12 per dag.

curl -sS https://geekie.nl/api/website-check \
  -H 'Content-Type: application/json' \
  -d '{"url": "example.nl"}'

Elke pagina als Markdown

Stuur Accept: text/markdown en je krijgt de pagina als Markdown terug op hetzelfde adres, met Vary: Accept. Zonder die header krijg je gewoon HTML. Elke pagina staat ook op /md/<pad>. Een pagina die niet bestaat geeft een 404 met een Markdown-uitleg en links naar llms.txt en de sitemap.

curl -sS -H 'Accept: text/markdown' https://geekie.nl/diensten/seo-en-geo
curl -sS https://geekie.nl/md/diensten/seo-en-geo

Foutmeldingen in JSON

Elke fout van /api is JSON met een vaste code, een uitleg, een hint om het verzoek te herstellen en een link naar deze pagina. Een pad onder /api dat niet bestaat geeft een JSON-404, een verkeerde methode een JSON-405 met de Allow-header.

{
  "error": "invalid_url",
  "code": "invalid_url",
  "message": "The url field must be the address of a public http(s) website.",
  "hint": "Send JSON such as {\"url\": \"example.nl\"} with Content-Type: application/json.",
  "docs": "https://geekie.nl/developers"
}

Contact: POST /api/contact

Het contactformulier accepteert alleen berichten vanaf de formulieren op geekie.nl. Wil een agent namens iemand contact opnemen, verwijs dan naar https://geekie.nl/contact of info@geekie.nl.