Changelog API
Format inspiré de Keep a Changelog. Versioning semver appliqué au préfixe d’URL (/v1/api, /v2/api…).
Politique de versions
| Type | Exemples | Déclenche |
|---|
| Breaking | Supprimer un champ, changer un code HTTP, renommer un endpoint | /v2/api |
| Minor | Nouvel endpoint, nouveau champ optionnel, nouveau filtre | v1 garde, ligne changelog |
| Patch | Fix validation, fix perf, fix doc | v1 garde, ligne changelog |
Déprécation
Headers renvoyés sur endpoint déprécié :
Deprecation: true
Sunset: Mon, 01 Jul 2026 00:00:00 GMT
Link: </v2/api/nouveau-path>; rel="successor-version"
[Unreleased]
Ajouts
- Endpoints
/webhooks/* (en design, voir Webhooks)
- Filtre
salaireMin / salaireMax sur /offres/search
Corrections
[2026.04.18] — Aujourd’hui
Ajouts
- Recherche full-text pondérée sur offres (tsvector A/B/C/D)
- Migration Flyway
V20260418093000__023_fulltext_search_vector.sql
- Endpoint
/offres/search?q=... exploite le nouvel index GIN
- Champ
relevanceScore dans OffreSearchResult.content[]
Changements
POST /auth/refresh-token : ajout de la rotation systématique du refresh token (invalide l’ancien)
Corrections
- Fix
candidat.profilPublic : les endpoints publics respectent désormais strictement ce flag
- Fix pagination sur
/recruiters/me/offres : totalPages incorrect si size=0
[2026.04.10]
Ajouts
- Module Vivier complet : 15 endpoints
/recruiters/me/viviers/*
- Import CSV de candidats externes dans un vivier
- Endpoint
POST /recruiters/me/viviers/{id}/invite
Changements
Entreprise.logoUrl retourne maintenant un objet { url, variants: { 128, 256, 512 } } au lieu d’une simple string
Changement rétrocompatible via Accept header. Clients v1 continuent à recevoir la string. Clients demandant Accept: application/vnd.hive.v2+json reçoivent l’objet.
[2026.03.20]
Ajouts
- Alertes email candidat :
/candidats/me/alertes/*
- Cron quotidien 07:00 UTC+1 pour matching
- Unsubscribe one-click
GET /alertes/unsubscribe?token=...
Corrections
- Rate limiting : header
CF-Connecting-IP désormais pris en compte en priorité (vrai IP client derrière Cloudflare)
[2026.02.15]
Ajouts
- Blog public :
/blog/* (liste, détail, commentaires)
- Blog admin :
/admin/blog/*
- Cover image avec variants responsive (600 / 1200 / 1920)
Changements
- Migration R2 terminée : tous les médias servis depuis
cdn.wethehivers.com
- MinIO décommissionné en prod
[2026.01.10]
Ajouts
- KYC recruteur : upload RCCM PDF + validation admin
- États recruteur :
PENDING_DOCS ajouté entre PENDING_EMAIL et PENDING_APPROVAL
[2025.12.05]
Ajouts
- Plans payants recruteur :
Gratuit, Essentiel, Pro, Entreprise
- Quota d’offres publiées selon plan (1 / 5 / 20 / illimité)
- Intégration Stripe (test uniquement)
Corrections
- Sécurité : CORS
allowedHeaders restreint (plus de wildcard)
[2025.11.01]
Ajouts
- Sous-rôles recruteur :
OWNER et MEMBER
- Membres multiples par entreprise
- Transfert de propriété entreprise entre owners
[2025.10.01] — v1 stable
Première version stable de l’API publique. Endpoints principaux :
Roadmap
- RSS :
https://docs.wethehivers.com/changelog.rss
- Email : s’inscrire sur
tech@wethehivers.com avec sujet “subscribe changelog”
- Discord : invitation sur demande
Voir aussi
