Voor ontwikkelaars

API-documentatie

Maak een API-sleutel aan op je account (Pro) en stuur hem mee als Authorization: Bearer bpw_…. Maximaal 120 verzoeken per minuut.

Wijnen toevoegen of bijwerken

Wijnen met hetzelfde external_id worden bijgewerkt. Zonder food_tags koppelen wij ze automatisch aan gerechten.

POST https://bijpassendewijn.nl/api/public/v1/wines
Content-Type: application/json

{ "wines": [{
  "external_id": "CH-001",
  "name": "Chablis",
  "producer": "Domaine Voorbeeld",
  "country": "Frankrijk", "region": "Bourgogne",
  "color": "wit",            // rood | wit | rosé | mousserend | dessert
  "grapes": ["Chardonnay"],
  "price_eur": 18.95, "vintage": 2022,
  "description": "Strak en mineraal.",
  "product_url": "https://jouwwinkel.nl/chablis"
}] }

Assortiment ophalen

GET https://bijpassendewijn.nl/api/public/v1/wines

Wijn verwijderen

DELETE https://bijpassendewijn.nl/api/public/v1/wines?external_id=CH-001

Wijnadvies bij een gerecht

Geeft passende wijnen uit je eigen assortiment (met matchscore) plus algemene wijnstijlen.

GET https://bijpassendewijn.nl/api/public/v1/pairing?gerecht=zalm%20uit%20de%20oven

{ "wines": [{ "name": "Chablis", "match_score": 92, ... }],
  "styles": [{ "title": "Frisse witte wijn", "grapes": ["Chardonnay"], ... }] }