Vue d'ensemble

L'API BeePass offre un accès programmatique à vos données de sélection : reines, évaluations, valeurs génétiques (EBV), pedigrees et exports. Toutes les opérations disponibles dans l'interface web sont accessibles via l'API REST.

Base URL

https://beepass.io/api/

Toutes les routes sont relatives à cette base. Par exemple, la liste des reines F0 est accessible via GET https://beepass.io/api/queens/f0.

Authentification

Toutes les routes nécessitent une session authentifiée via Supabase Auth (cookies SSR). Les routes d'administration nécessitent en plus un cookie HMAC beepass-admin-token.

Consultez la page Authentification pour les détails complets.

Format

• Requêtes : Content-Type: application/json
• Réponses : JSON
• Encodage : UTF-8

Pagination

Les endpoints de liste supportent la pagination via query parameters :

Paramètre	Type	Défaut	Description
limit	integer	20	Nombre d'éléments par page (max 100)
offset	integer	0	Nombre d'éléments à sauter

Codes d'erreur

Code	Description
400	Bad Request — paramètres invalides ou corps de requête malformé
401	Unauthorized — session manquante ou expirée
403	Forbidden — permissions insuffisantes (ex: accès admin requis)
404	Not Found — ressource inexistante ou non possédée
429	Too Many Requests — limite de requêtes dépassée
500	Internal Server Error — erreur côté serveur

Les erreurs retournent un objet JSON :

{
  "error": "Description du problème"
}

Rate Limiting

Les limites de requêtes sont appliquées via Upstash Redis :

Action	Limite
Login	10 tentatives / 15 minutes
Inscription	3 / heure
Envoi code vérification	5 / 10 minutes
Vérification code	10 / minute

RLS (Row Level Security)

Toutes les données sont scopées à l'utilisateur authentifié via owner_id = auth.uid(). Vous ne pouvez accéder qu'à vos propres reines, évaluations et résultats. Les données de référence (index BeePass) sont en lecture seule pour tous les utilisateurs authentifiés.

---

Voir aussi : Authentification | Clés API | Reines | Évaluations | EBV | Export