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 sauf logout. 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…).

​API Reference

​Base URL

​Vue macro

​Décomposition par module

​Authentification (13)

​Candidats (34)

​Recruteurs (28)

​Offres & candidatures (27)

​Vivier (11)

​Fichiers (9)

​Public (6)

​Données de référence géo (11)

​Admin (33)

​Index cartographique

​Conventions communes

​Recherche interactive