API Reference
L’API THE HIVE expose 172 endpoints regroupés par module métier. Toutes les URLs sont préfixées par/v1/api.
Base URL
| Environnement | URL |
|---|---|
| Production | https://api.wethehivers.com/v1/api |
| Staging | https://staging-api.wethehivers.com/v1/api |
| Dev local | http://localhost:3091/v1/api |
Vue macro
Décomposition par module
Authentification (13)
Inscription, login, logout, refresh, email validation, reset password — tous publics sauflogout.
Voir : Auth endpoints.
Candidats (34)
Profil, CV multiples, photo, compétences, préférences de recherche, favoris, alertes, dashboard. Sous-modules :- Profil — 15 endpoints
- Favoris — 7 endpoints
- Alertes — 8 endpoints
- Dashboard — 1 endpoint
- Auth candidat — 1 endpoint (register spécifique)
- Candidatures (vue candidat) — 2 endpoints
Recruteurs (28)
Profil, entreprise associée, dashboard, offres publiées, candidatures reçues. Sous-modules :- Auth recruteur — 6 endpoints
- Dashboard — 1 endpoint
- Offres (vue recruteur) — 14 endpoints
- Candidatures (vue recruteur) — 7 endpoints
Offres & candidatures (27)
- Offres — 14 endpoints (CRUD + search + autocomplete + stats)
- Candidatures — 12 endpoints (postuler, suivre, notes, rejet, status change)
- Entreprises publiques — 3 endpoints
Vivier (11)
Gestion d’une base de candidats par recruteur (inscrits + externes + favoris).Fichiers (9)
Upload R2 derrière le backend (scan AV + validation). Types : CV, logo, bannière, photo profil, photo staff, cover article blog, image article générique.Public (6)
Endpoints sans authentification :- Blog : liste articles, détail par slug, catégories — 3 endpoints
- Entreprises : annuaire public, détail, count offres — 3 endpoints
Données de référence géo (11)
Pays, régions, villes, secteurs, types de contrat, niveaux d’expérience. Cache 24 h recommandé. Voir : Données géo.Admin (33)
Sous-modules :- Dashboard — 4 endpoints
- Compte — 3 endpoints
- Candidats — 7 endpoints
- Recruteurs — 10 endpoints
- Entreprises — 5 endpoints
- Offres — 4 endpoints
- Candidatures — 3 endpoints
- Blog — 7 endpoints
- Référence (CRUD) — 20 endpoints
Index cartographique
| Module | # | Base path | Rôles |
|---|---|---|---|
| Auth | 7 | /auth/* | Public |
| Auth candidat | 1 | /auth/candidats/register | Public |
| Auth recruteur | 6 | /auth/recruiters/* | Public + RECRUTEUR |
| Candidats — Profil | 15 | /candidats/me/* | CANDIDAT |
| Candidats — Dashboard | 1 | /candidats/me/dashboard | CANDIDAT |
| Candidats — Alertes | 8 | /candidats/me/alertes/* | CANDIDAT |
| Candidats — Favoris | 7 | /candidats/me/favoris/* | CANDIDAT |
| Offres | 14 | /offres/*, /recruiters/me/offres/* | Mixte |
| Candidatures | 12 | /candidatures/* | CANDIDAT + RECRUTEUR |
| Recruteur — Dashboard | 1 | /recruiters/me/dashboard | RECRUTEUR |
| Vivier | 11 | /recruiters/me/viviers/* | RECRUTEUR |
| Fichiers | 9 | /files/* | Selon type |
| Référence géo | 11 | /pays, /regions, /villes, /secteurs, … | Public |
| Blog public | 3 | /blog/* | Public |
| Entreprises publiques | 3 | /entreprises/* | Public |
| Admin — Dashboard | 4 | /admin/dashboard/* | ADMIN |
| Admin — Compte | 3 | /admin/me/* | ADMIN |
| Admin — Candidats | 7 | /admin/candidats/* | ADMIN |
| Admin — Recruteurs | 10 | /admin/recruiters/* | ADMIN |
| Admin — Entreprises | 5 | /admin/entreprises/* | ADMIN |
| Admin — Offres | 4 | /admin/offres/* | ADMIN |
| Admin — Candidatures | 3 | /admin/candidatures/* | ADMIN |
| Admin — Blog | 7 | /admin/blog/* | ADMIN |
| Admin — Référence | 20 | /admin/reference/* | ADMIN |
| Total | 172 |
Conventions communes
Voir aussi :Recherche interactive
Collections Postman/Insomnia/Bruno
172 requêtes pré-configurées à importer en un clic.
OpenAPI 3.0
Spec complète téléchargeable pour générer clients typés.
Snippets JS / Java / Python
Exemples prêts à copier pour les stacks courantes.
FAQ développeur
Debug rapide des erreurs fréquentes (401, 403, 429, 422…).