Voor ontwikkelaars

API-documentatie

Maak een API-sleutel aan op je account (Pro Plus) 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

WooCommerce: vul je API-sleutel in bij de plugininstellingen, kies een wijncategorie en schakel synchronisatie in. Prijzen en productlinks worden bij wijzigingen bijgewerkt. Shopify vereist een aparte beveiligde app-koppeling; het themapakket toont alleen de widget.

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

Wijn verwijderen

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

Limieten

Maximaal 120 verzoeken per minuut per sleutel. Elk antwoord bevat de header RateLimit-Policy; bij overschrijding krijg je status 429 met RateLimit en Retry-After (seconden).

Versiebeleid

De versie staat in het adres (/v1). Wijzigingen binnen v1 zijn altijd uitbreidingen. Een versie die vervalt kondigen we minimaal 6 maanden vooraf aan per e-mail en met de headers Deprecation en Sunset.

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"], ... }] }

Menukaart downloaden

Ontwerp de kaart in je account en sla hem op met 'beschikbaar in widget en plugins'. Alleen een gepubliceerde Pro Plus-menukaart is downloadbaar. Dezelfde knop verschijnt automatisch in WordPress en Shopify.

GET https://www.bijpassendewijn.nl/api/public/menu/JOUW-WINKEL-ID