Skip to main content

​
Bienvenue sur l’API THE HIVE

THE HIVE est une plateforme de recrutement et un jobboard dédié au marché camerounais. L’API connecte trois acteurs : les candidats qui recherchent un emploi, les recruteurs qui publient des offres et gèrent les candidatures, et les administrateurs qui modèrent la plateforme.

​
Concepts clés

Candidats

Les candidats créent un profil complet (CV, photo, compétences), consultent les offres d’emploi et postulent aux postes qui les intéressent.

Recruteurs

Les recruteurs représentent une entreprise vérifiée, publient des offres d’emploi et gèrent le pipeline de candidatures.

Candidatures

Chaque candidature suit un cycle de vie clair : reçue, à rencontrer, en cours, entretien passé, embauché ou refusé.

Entreprises

Les entreprises sont vérifiées par l’administration avant de pouvoir publier. Chaque recruteur est rattaché à une entreprise.

​
Comment ça marche

​
Base URL

Toutes les routes sont préfixées : 
https://api.wethehivers.com/v1/api
En développement local : 
http://localhost:3091/api

​
Démarrage rapide

1

Créer un compte

Candidat : POST /api/auth/candidate/register — Recruteur : POST /api/auth/recruiter/register
2

Se connecter

POST /api/auth/login — renvoie un access token (15 min) et un refresh token (7 jours).
3

Explorer l'API

Candidat : consulter les offres et postuler. Recruteur : attendre validation admin, puis publier des offres.
4

Swagger UI

La documentation interactive complète est disponible en local sur http://localhost:3091/api/swagger-ui.html.