Developer API

API-overeenkomst (v1-2026)

Deze API geeft read-only toegang tot onze histaminecatalogus en recepten zodat je zelf applicaties kunt bouwen (bijvoorbeeld een native app) voor mensen met histamine-intolerantie.

1. Medische disclaimer — De gegevens zijn uitsluitend informatief en vervangen geen professioneel medisch of dieetkundig advies. Jouw applicatie moet een vergelijkbare disclaimer aan gebruikers tonen.

2. Bronvermelding — Applicaties die deze API gebruiken vermelden "Histamine & Voeding / The Histamine Food list" als databron, waar praktisch met een link.

3. Redelijk gebruik — Respecteer de gepubliceerde rate limits. Scrapen, bulk-herdistributie of doorverkoop van de ruwe dataset is niet toegestaan. Caching voor de performance van je eigen applicatie mag.

4. Inloggegevens — Houd je client secret geheim. Je bent verantwoordelijk voor al het gebruik onder jouw credentials. Vernieuw de secret direct bij een vermoeden van een lek.

5. Beschikbaarheid & wijzigingen — De API wordt geleverd zoals hij is, zonder uptimegaranties. Endpoints kunnen wijzigen of vervallen; breaking changes komen waar redelijkerwijs mogelijk onder een nieuw versievoorvoegsel.

6. Beëindiging — Wij kunnen credentials intrekken die deze overeenkomst schenden of de dienst in gevaar brengen.

Door te accepteren bevestig je dat je deze voorwaarden hebt gelezen en ermee akkoord gaat. Je acceptatie (versie en tijdstip) wordt bij je account vastgelegd.

Snel starten

Volledige interactieve documentatie van elk endpoint — probeer calls direct vanuit je browser met je token:

# 1. Exchange your credentials for a 1h access token
curl -X POST https://api.histaminevoeding.nl/v1/auth/token \
  -H 'Content-Type: application/json' \
  -d '{"clientId":"hfl_...","clientSecret":"hfls_..."}'

# 2. Call the read-only v1 API with the token
curl 'https://api.histaminevoeding.nl/v1/products?lang=en' \
  -H 'Authorization: Bearer <access_token>'