| Endpoint | Wat erin zit |
|---|---|
| /api/index.json | Begin hier. Eén fetch met alles wat er bestaat, plus hoe je de scores hoort te lezen. |
| /api/plants.json | Alle 348 planten met scores, kenmerken en onderbouwing. Eén bestand. |
| /api/compact.json | Alleen namen en de vier scores. Klein genoeg om in een prompt te plakken. |
| /api/plant/{id}.json | Eén plant. Bv. /api/plant/lavendel.json |
| /api/by/sun/{positie}.json | Per standplaats: zon, halfschaduw of schaduw. |
| /api/by/tag/{tag}.json | Per kenmerk. Bv. /api/by/tag/bijvriendelijk.json |
| /api/top/{as}.json | Top 25 op één as: biodiversity, maintenance, placement of looks. |
| /api/lists.json | De 9 kant-en-klare lijsten, met de plant-ids erin. |
| /api/schema.json | JSON Schema van een plantrecord. Valideer ertegen voordat je erop bouwt. |
| /plants.csv | Dezelfde data plat, voor een spreadsheet of een notebook. |
| /llms.txt | Korte instructie + de hele lijst als platte tekst, voor een taalmodel dat de site leest. |
Zo ziet één plant eruit
{
"id": "lavendel",
"url": "https://oerbloei.pages.dev/plant/lavendel",
"name_nl": "Lavendel",
"name_latin": "Lavandula angustifolia 'Hidcote'",
"native_to_netherlands": false,
"scores": {
"biodiversity": 4,
"maintenance": 4,
"placement": 3,
"looks": 5,
"overall": 4
},
"sun": ["zon"],
"height_cm": { "min": 40, "max": 60 },
"flowering": { "from_month": 6, "to_month": 8, "colors": ["paars"] },
"uses": ["geur"],
"score_source": "hand"
} De regels, kort
- Alle scores zijn 0–5, en hoger is altijd beter. Ook
maintenance: dat is onderhoudsgemak, niet onderhoudslast. 5 betekent bijna geen werk. -
overallis het ongewogen gemiddelde van de vier. Wil je anders wegen, reken het zelf uit — de vier getallen staan erbij. -
score_sourcezegt hoe zeker het is.hand= feiten één voor één nagelopen.model= geschat uit bekende eigenschappen. Waarom een score is wat hij is, staat voor elke plant inscore_breakdown. - Velden worden toegevoegd, niet hernoemd. Verdwijnt er een veld, dan
gaat
versioneen hoofdnummer omhoog (2.0:score_reasons_nlis weg). In 2.1 kwamuseserbij: waar je de plant voor plukt. - CC BY 4.0. Gebruik het, ook commercieel. Noem Oerbloei als bron en link terug, zodat iemand kan nakijken waar een score op gebaseerd is.
Ophalen
curl https://oerbloei.pages.dev/api/plants.json
# alleen de inheemse planten met de hoogste biodiversiteitsscore
curl -s https://oerbloei.pages.dev/api/plants.json \
| jq '.plants[] | select(.native_to_netherlands and .scores.biodiversity == 5) | .name_nl' Bouw je een agent of een plugin? Begin bij /llms.txt — daar staat in een paar regels wat de scores betekenen, gevolgd door de hele lijst in platte tekst. Klein genoeg om in één keer mee te geven.