Overzicht

De BeePass API biedt programmatische toegang tot uw fokgegevens: koninginnen, evaluaties, geschatte fokwaarden (EBV), stambomen en exports. Alle bewerkingen die beschikbaar zijn in de webinterface zijn toegankelijk via de REST API.

Basis-URL

https://beepass.io/api/

Alle routes zijn relatief ten opzichte van deze basis. Bijvoorbeeld, de F0-koninginnenlijst is toegankelijk via GET https://beepass.io/api/queens/f0.

Authenticatie

Alle routes vereisen een geauthenticeerde sessie via Supabase Auth (SSR-cookies). Beheerdersroutes vereisen daarnaast een HMAC-cookie beepass-admin-token.

Zie de pagina Authenticatie voor volledige details.

Formaat

Verzoeken: Content-Type: application/json
Antwoorden: JSON
Codering: UTF-8

Paginering

Lijstendpoints ondersteunen paginering via queryparameters:

Parameter	Type	Standaard	Beschrijving
`limit`	integer	20	Aantal items per pagina (max 100)
`offset`	integer	0	Aantal items om over te slaan

Foutcodes

Code	Beschrijving
`400`	Bad Request — ongeldige parameters of onjuist geformuleerde verzoektekst
`401`	Unauthorized — ontbrekende of verlopen sessie
`403`	Forbidden — onvoldoende rechten (bijv. beheerderstoegang vereist)
`404`	Not Found — resource bestaat niet of is niet van u
`429`	Too Many Requests — limiet overschreden
`500`	Internal Server Error — serverfout

Fouten retourneren een JSON-object:

{
  "error": "Beschrijving van het probleem"
}

Rate Limiting

Verzoeklimieten worden afgedwongen via Upstash Redis:

Actie	Limiet
Login	10 pogingen / 15 minuten
Registratie	3 / uur
Verificatiecode verzenden	5 / 10 minuten
Verificatiecode controleren	10 / minuut

RLS (Row Level Security)

Alle gegevens zijn beperkt tot de geauthenticeerde gebruiker via owner_id = auth.uid(). U hebt alleen toegang tot uw eigen koninginnen, evaluaties en resultaten. Referentiegegevens (BeePass Index) zijn alleen-lezen voor alle geauthenticeerde gebruikers.

Basis-URL​

Authenticatie​

Formaat​

Paginering​

Foutcodes​

Rate Limiting​

RLS (Row Level Security)​