Versioning

THE HIVE suit un versioning par préfixe d’URL. La version courante est v1 — tous les endpoints sont préfixés par /v1/api/.

Politique

Phase	Durée	Statut
Current	Jusqu’à la prochaine version	Activement développée
Deprecated	6 mois après sortie de la suivante	Encore servie + header `Deprecation`
End of life	Après les 6 mois	Retour `410 Gone`

Une version reste servie pendant minimum 12 mois après sa sortie.

Change	Breaking ?
Ajout d’un endpoint	Non
Ajout d’un champ optionnel à une réponse	Non
Ajout d’un champ optionnel à une requête	Non
Retrait d’un endpoint	Oui
Retrait d’un champ de réponse	Oui
Renommage d’un champ	Oui
Changement de type d’un champ	Oui
Changement de comportement silencieux	Oui
Rendre obligatoire un champ optionnel	Oui
Ajout d’une règle de validation plus stricte	Oui
Changement du format de date	Oui

Lorsque v2 est en place, v1 retournera :

HTTP/1.1 200 OK
Deprecation: true
Sunset: Sat, 18 Oct 2026 23:59:59 GMT
Link: <https://docs.wethehivers.com/migration-v2>; rel="deprecation"

Premier release public.

172 endpoints exposés
9 modules : auth, candidats, recruteurs, offres, candidatures, vivier, fichiers, admin, référence
OpenAPI 3.0 spec publique
Authentification JWT (access + refresh)
Stockage Cloudflare R2
Recherche plein-texte PostgreSQL (tsvector)
Intégration Cloudflare + DDoS protection

Aucune déprécation active à ce jour.

Les breaking changes majeurs sont annoncés :

En interne le backend suit SemVer (MAJOR.MINOR.PATCH) mais seul le MAJOR impacte le préfixe d’URL.