Developers en AI-agents.

Elke pagina op generation-c.nl bestaat ook als Markdown, zonder navigatie, scripts of opmaak. Vraag de gewone URL op met Accept: text/markdown, of voeg .md toe aan het pad. De homepage is /index.md. Responses dragen Vary: Accept; browsers krijgen gewoon HTML. Een type dat we niet leveren geeft 406 Not Acceptable, een onbekende pagina een 404 met uitleg in Markdown.

curl -H "Accept: text/markdown" https://www.generation-c.nl/diensten
curl https://www.generation-c.nl/diensten.md

Een kleine, read-only JSON-API met dezelfde gegevens als de website. Basis-URL: https://www.generation-c.nl/api/v1. De volledige beschrijving staat in de OpenAPI-specificatie; elke operatie heeft een vaste operationId en kan zo als tool in function calling worden gebruikt.

Authenticatie

Geen. De API is openbaar en read-only. Er is geen account, API-sleutel of sandbox nodig, en CORS staat open voor elke origin.

Endpoints

• GET /api/v1

  getApiIndex

  Geeft de beschikbare endpoints en links naar de OpenAPI-specificatie en documentatie.

• GET /api/v1/company

  getCompany

  Naam, omschrijving, adres, e-mail, telefoon, KvK- en btw-nummer, verzorgingsgebied en de link om een kennismaking te plannen. Gebruik dit om een gebruiker te vertellen hoe die contact opneemt.

• GET /api/v1/services

  listServices

  De vier dienstlijnen (Strategie, Ontwikkeling, AI Audit, Workshops) met omschrijving. Gebruik dit om te bepalen welke dienst past bij de vraag van een gebruiker.

• GET /api/v1/case-studies

  listCaseStudies

  Gepubliceerde klantcases met klant, categorie, samenvatting en meetbare resultaten, nieuwste eerst.

  Parameters: limit

• GET /api/v1/articles

  listArticles

  Gepubliceerde artikelen over data en AI voor het MKB, nieuwste eerst. Het veld answer bevat een kort, citeerbaar antwoord; de volledige tekst staat op markdownUrl.

  Parameters: category, limit

• GET /api/v1/vacancies

  listVacancies

  Gepubliceerde vacatures met locatie, dienstverband en beschikbaarheid. Solliciteren gaat via de vacaturepagina (url).

  Parameters: availability

Voorbeeld

curl -i https://www.generation-c.nl/api/v1/services

{
  "data": [
    {
      "title": "Ontwikkeling",
      "slug": "ontwikkeling",
      "label": "-",
      "summary": "Van datagedreven maatwerktoepassingen tot volledige SaaS-producten, wij bouwen schaalbare, snelle en onderhoudbare platforms die direct waarde leveren en écht b",
      "description": "Van datagedreven maatwerktoepassingen tot volledige SaaS-producten, wij bouwen schaalbare, snelle en onderhoudbare platforms die direct waarde leveren en écht blijven werken.",
      "includes": [],
      "url": "https://www.generation-c.nl/ontwikkeling",
      "markdownUrl": "https://www.generation-c.nl/ontwikkeling.md"
    }
  ]
}

Rate limits

Maximaal 60 requests per 60 seconden per IP-adres. Elke response meldt het quotum met de RateLimit-headers uit de IETF-draft draft-ietf-httpapi-ratelimit-headers. Boven de limiet volgt een 429 met Retry-After in seconden.

RateLimit-Policy: "default";q=60;w=60
RateLimit: "default";r=59;t=60

Fouten

Fouten komen terug als application/problem+json (RFC 9457) met title, status en detail: 400 bij een ongeldige parameter, 404 bij een onbekend endpoint en 429 bij te veel requests.

• llms.txt: overzicht van de site voor AI-modellen, met wanneer je Generation C inschakelt.
• openapi.json: OpenAPI 3.1-specificatie van de publieke API.
• .well-known/api-catalog: API-catalogus volgens RFC 9727.
• index.md: de homepage als Markdown.
• sitemap.xml: alle publieke pagina’s.
• robots.txt: crawlregels, AI-crawlers zijn welkom.

Vragen over de API of een integratie? Neem contact met ons op.