# THE HIVE API

## Docs

- [Mon profil](https://docs.wethehivers.com/api-reference/admin-account/getprofile.md): Récupère les informations du profil de l'admin connecté
- [Modifier mon mot de passe](https://docs.wethehivers.com/api-reference/admin-account/updatepassword.md): Met à jour le mot de passe de l'admin connecté
- [Modifier mon profil](https://docs.wethehivers.com/api-reference/admin-account/updateprofile.md): Met à jour les informations du profil de l'admin connecté
- [Creer un article de blog](https://docs.wethehivers.com/api-reference/admin-blog/createarticle.md): Cree un nouvel article de blog avec generation automatique du slug
- [Supprimer un article de blog](https://docs.wethehivers.com/api-reference/admin-blog/deletearticle.md): Supprime definitivement un article de blog
- [Lister les articles de blog](https://docs.wethehivers.com/api-reference/admin-blog/getallarticles.md): Recupere tous les articles de blog avec pagination et filtre optionnel par categorie
- [Detail d'un article de blog](https://docs.wethehivers.com/api-reference/admin-blog/getarticlebyid.md): Recupere tous les details d'un article de blog
- [Publier un article de blog](https://docs.wethehivers.com/api-reference/admin-blog/publisharticle.md): Publie un article de blog pour le rendre visible sur le frontend candidat
- [Depublier un article de blog](https://docs.wethehivers.com/api-reference/admin-blog/unpublisharticle.md): Depublie un article de blog pour le retirer du frontend candidat
- [Mettre a jour un article de blog](https://docs.wethehivers.com/api-reference/admin-blog/updatearticle.md): Met a jour le contenu d'un article de blog existant
- [Supprimer candidat](https://docs.wethehivers.com/api-reference/admin-candidats/deletecandidate.md): Supprime un candidat (soft delete)
- [Lister candidats](https://docs.wethehivers.com/api-reference/admin-candidats/getallcandidates.md): Récupère tous les candidats avec pagination, filtrage par statut et recherche
- [Détail candidat](https://docs.wethehivers.com/api-reference/admin-candidats/getcandidatedetail.md): Récupère tous les détails d'un candidat
- [Compter candidats](https://docs.wethehivers.com/api-reference/admin-candidats/getcount.md): Retourne le nombre total de candidats
- [Réactiver candidat](https://docs.wethehivers.com/api-reference/admin-candidats/reactivatecandidate.md): Réactive un candidat suspendu
- [Suspendre candidat](https://docs.wethehivers.com/api-reference/admin-candidats/suspendcandidate.md): Suspend un candidat (désactive son compte)
- [Modifier candidat](https://docs.wethehivers.com/api-reference/admin-candidats/updatecandidate.md): Met à jour les informations d'un candidat
- [Lister candidatures](https://docs.wethehivers.com/api-reference/admin-candidatures/getallcandidatures.md): Recupere toutes les candidatures avec pagination, filtrage par statut et recherche
- [Compter candidatures](https://docs.wethehivers.com/api-reference/admin-candidatures/getcandidaturecount.md): Retourne le nombre total de candidatures, avec filtre optionnel par statut
- [Detail candidature](https://docs.wethehivers.com/api-reference/admin-candidatures/getcandidaturedetail.md): Recupere tous les details d'une candidature
- [Données graphique](https://docs.wethehivers.com/api-reference/admin-dashboard/getchartdata.md): Récupère les données d'inscriptions pour le graphique
- [Statistiques dashboard](https://docs.wethehivers.com/api-reference/admin-dashboard/getdashboardstats-2.md): Récupère toutes les statistiques pour le dashboard admin
- [Top candidats](https://docs.wethehivers.com/api-reference/admin-dashboard/gettopcandidates.md): Récupère les meilleurs candidats basés sur le score de profil
- [Top entreprises](https://docs.wethehivers.com/api-reference/admin-dashboard/gettopcompanies.md): Récupère les meilleures entreprises basées sur le nombre de recruteurs
- [Lister entreprises](https://docs.wethehivers.com/api-reference/admin-entreprises/getallcompanies.md): Récupère toutes les entreprises avec pagination et recherche
- [Compter entreprises](https://docs.wethehivers.com/api-reference/admin-entreprises/getcompanycount.md): Retourne le nombre total d'entreprises
- [Détail entreprise](https://docs.wethehivers.com/api-reference/admin-entreprises/getcompanydetail.md): Récupère tous les détails d'une entreprise
- [Réactiver entreprise](https://docs.wethehivers.com/api-reference/admin-entreprises/reactivatecompany.md): Réactive une entreprise suspendue
- [Suspendre entreprise](https://docs.wethehivers.com/api-reference/admin-entreprises/suspendcompany.md): Suspend une entreprise (désactive son activité)
- [Lister offres d'emploi](https://docs.wethehivers.com/api-reference/admin-offres/getalljoboffers.md): Récupère toutes les offres d'emploi avec pagination, filtrage par statut et recherche
- [Compter offres d'emploi](https://docs.wethehivers.com/api-reference/admin-offres/getjoboffercount.md): Retourne le nombre total d'offres d'emploi, avec filtre optionnel par statut
- [Détail offre d'emploi](https://docs.wethehivers.com/api-reference/admin-offres/getjobofferdetail.md): Récupère tous les détails d'une offre d'emploi
- [Retirer offre d'emploi](https://docs.wethehivers.com/api-reference/admin-offres/removejoboffer.md): Archive une offre d'emploi par décision admin (raison obligatoire)
- [Lister tous les recruteurs](https://docs.wethehivers.com/api-reference/admin-recruteurs/getallrecruiters.md): Récupère une liste paginée de tous les recruteurs avec filtres
- [Compter recruteurs PENDING](https://docs.wethehivers.com/api-reference/admin-recruteurs/getpendingcount.md): Retourne le nombre de recruteurs en attente de validation
- [Lister recruteurs PENDING](https://docs.wethehivers.com/api-reference/admin-recruteurs/getpendingrecruiters.md): Récupère tous les recruteurs en attente de validation
- [Détail recruteur](https://docs.wethehivers.com/api-reference/admin-recruteurs/getrecruiterdetail.md): Récupère tous les détails d'un recruteur
- [Historique des changements de statut](https://docs.wethehivers.com/api-reference/admin-recruteurs/getrecruiterstatushistory.md): Récupère l'historique complet des changements de statut d'un recruteur
- [Réactiver recruteur](https://docs.wethehivers.com/api-reference/admin-recruteurs/reactivaterecruiter.md): Réactive un recruteur SUSPENDED (réactive son compte)
- [Rejeter recruteur](https://docs.wethehivers.com/api-reference/admin-recruteurs/rejectrecruiter.md): Rejette un recruteur PENDING (envoie email avec raison)
- [Revalider recruteur](https://docs.wethehivers.com/api-reference/admin-recruteurs/revalidaterecruiter.md): Revalide un recruteur REJECTED (envoie email avec token pour mot de passe)
- [Suspendre recruteur](https://docs.wethehivers.com/api-reference/admin-recruteurs/suspendrecruiter.md): Suspend un recruteur VALIDATED (désactive son compte)
- [Valider recruteur](https://docs.wethehivers.com/api-reference/admin-recruteurs/validaterecruiter.md): Valide un recruteur PENDING (envoie email avec token pour mot de passe)
- [Créer une ville](https://docs.wethehivers.com/api-reference/admin-reference/createcity.md): Crée une nouvelle ville dans une région
- [Créer un pays](https://docs.wethehivers.com/api-reference/admin-reference/createcountry.md): Crée un nouveau pays
- [Créer un niveau d'expérience](https://docs.wethehivers.com/api-reference/admin-reference/createexperiencelevel.md): Crée un nouveau niveau d'expérience
- [Créer une région](https://docs.wethehivers.com/api-reference/admin-reference/createregion.md): Crée une nouvelle région dans un pays
- [Créer un secteur](https://docs.wethehivers.com/api-reference/admin-reference/createsector.md): Crée un nouveau secteur d'activité
- [Supprimer une ville](https://docs.wethehivers.com/api-reference/admin-reference/deletecity.md): Supprime une ville
- [Supprimer un pays](https://docs.wethehivers.com/api-reference/admin-reference/deletecountry.md): Supprime un pays (si aucune région n'y est rattachée)
- [Supprimer un niveau d'expérience](https://docs.wethehivers.com/api-reference/admin-reference/deleteexperiencelevel.md): Supprime un niveau d'expérience
- [Supprimer une région](https://docs.wethehivers.com/api-reference/admin-reference/deleteregion.md): Supprime une région (si aucune ville n'y est rattachée)
- [Supprimer un secteur](https://docs.wethehivers.com/api-reference/admin-reference/deletesector.md): Supprime un secteur d'activité (si aucune entreprise n'y est rattachée)
- [Lister les villes d'une région](https://docs.wethehivers.com/api-reference/admin-reference/getallcities.md): Récupère toutes les villes d'une région
- [Lister les pays](https://docs.wethehivers.com/api-reference/admin-reference/getallcountries.md): Récupère tous les pays avec le nombre de régions
- [Lister les niveaux d'expérience](https://docs.wethehivers.com/api-reference/admin-reference/getallexperiencelevels.md): Récupère tous les niveaux d'expérience triés par ordre
- [Lister les régions d'un pays](https://docs.wethehivers.com/api-reference/admin-reference/getallregions.md): Récupère toutes les régions d'un pays avec le nombre de villes
- [Lister les secteurs](https://docs.wethehivers.com/api-reference/admin-reference/getallsectors.md): Récupère tous les secteurs d'activité avec le nombre d'entreprises
- [Modifier une ville](https://docs.wethehivers.com/api-reference/admin-reference/updatecity.md): Met à jour une ville existante
- [Modifier un pays](https://docs.wethehivers.com/api-reference/admin-reference/updatecountry.md): Met à jour un pays existant
- [Modifier un niveau d'expérience](https://docs.wethehivers.com/api-reference/admin-reference/updateexperiencelevel.md): Met à jour un niveau d'expérience existant
- [Modifier une région](https://docs.wethehivers.com/api-reference/admin-reference/updateregion.md): Met à jour une région existante
- [Modifier un secteur](https://docs.wethehivers.com/api-reference/admin-reference/updatesector.md): Met à jour un secteur d'activité existant
- [Inscription candidat](https://docs.wethehivers.com/api-reference/auth-candidat/register-1.md): Inscrit un nouveau candidat (avec mot de passe, email à valider)
- [Changer le mot de passe](https://docs.wethehivers.com/api-reference/auth-recruteur/changepassword.md): Change le mot de passe du recruteur connecté
- [Mon entreprise](https://docs.wethehivers.com/api-reference/auth-recruteur/getmycompany.md): Récupère les informations de l'entreprise du recruteur connecté
- [Mon profil](https://docs.wethehivers.com/api-reference/auth-recruteur/getmyprofile.md): Récupère les informations du recruteur connecté
- [Inscription recruteur](https://docs.wethehivers.com/api-reference/auth-recruteur/register.md): Inscrit un nouveau recruteur (sans mot de passe, statut PENDING)
- [Définir mot de passe](https://docs.wethehivers.com/api-reference/auth-recruteur/setpassword.md): Définit le mot de passe du recruteur après validation admin (via token)
- [Mettre à jour mon entreprise](https://docs.wethehivers.com/api-reference/auth-recruteur/updatemycompany.md): Met à jour les informations de l'entreprise du recruteur connecté
- [Mot de passe oublié](https://docs.wethehivers.com/api-reference/auth/forgotpassword.md): Envoie un email avec un lien pour réinitialiser le mot de passe. Retourne toujours un succès pour ne pas révéler l'existence du compte (sécurité).
- [Connexion utilisateur](https://docs.wethehivers.com/api-reference/auth/login.md): Authentifie un utilisateur avec email et mot de passe. Retourne un access token (15 min) et un refresh token (7 jours) dans le corps de la réponse ET dans des cookies HttpOnly sécurisés. Les recruteurs doivent avoir le statut VALIDATED pour se connecter.
- [Déconnexion utilisateur](https://docs.wethehivers.com/api-reference/auth/logout.md): Déconnecte l'utilisateur et révoque son token JWT. Le token est ajouté à la blacklist et ne pourra plus être utilisé. Les cookies HttpOnly sont également supprimés. Nécessite un token JWT valide dans le header Authorization ou cookie.
- [Rafraîchir l'access token](https://docs.wethehivers.com/api-reference/auth/refreshtoken.md): Génère un nouvel access token à partir d'un refresh token valide. Le refresh token reste inchangé. À utiliser lorsque l'access token expire. Le refresh token peut être fourni dans le corps de la requête ou dans un cookie HttpOnly.
- [Renvoyer email validation](https://docs.wethehivers.com/api-reference/auth/resendvalidationemail.md): Renvoie un email de validation à un candidat
- [Réinitialiser mot de passe](https://docs.wethehivers.com/api-reference/auth/resetpassword.md): Réinitialise le mot de passe d'un utilisateur via le token reçu par email (mot de passe oublié)
- [Valider email](https://docs.wethehivers.com/api-reference/auth/validateemail.md): Valide l'adresse email d'un candidat via token (reçu par email)
- [Compter les alertes](https://docs.wethehivers.com/api-reference/candidats-alertes/countalerts.md): Compte le nombre d'alertes du candidat
- [Créer une alerte SEARCH](https://docs.wethehivers.com/api-reference/candidats-alertes/createsearchalert.md): Crée une alerte basée sur des critères de recherche
- [Supprimer une alerte](https://docs.wethehivers.com/api-reference/candidats-alertes/deletealert.md): Supprime une alerte emploi
- [Lister les alertes](https://docs.wethehivers.com/api-reference/candidats-alertes/getalerts.md): Récupère toutes les alertes emploi du candidat
- [Statut alerte PROFILE](https://docs.wethehivers.com/api-reference/candidats-alertes/hasactiveprofilealert.md): Vérifie si l'alerte profil est active
- [Activer/Désactiver une alerte](https://docs.wethehivers.com/api-reference/candidats-alertes/togglealert.md): Change l'état actif d'une alerte
- [Activer/Désactiver alerte PROFILE](https://docs.wethehivers.com/api-reference/candidats-alertes/toggleprofilealert.md): Active ou désactive l'alerte basée sur le profil du candidat
- [Désabonnement par token](https://docs.wethehivers.com/api-reference/candidats-alertes/unsubscribebytoken.md): Désactive une alerte via le token de désabonnement (accessible sans connexion)
- [Statistiques dashboard](https://docs.wethehivers.com/api-reference/candidats-dashboard/getdashboardstats-1.md): Récupère les statistiques pour le dashboard candidat
- [Compter les favoris](https://docs.wethehivers.com/api-reference/candidats-favoris/countsavedjobs.md): Compte le nombre d'offres sauvegardées
- [IDs des favoris](https://docs.wethehivers.com/api-reference/candidats-favoris/getsavedjobids.md): Récupère les IDs des offres sauvegardées
- [Lister les offres sauvegardées](https://docs.wethehivers.com/api-reference/candidats-favoris/getsavedjobs.md): Récupère les offres sauvegardées du candidat avec pagination
- [Vérifier si sauvegardée](https://docs.wethehivers.com/api-reference/candidats-favoris/isjobsaved.md): Vérifie si une offre est dans les favoris
- [Sauvegarder une offre](https://docs.wethehivers.com/api-reference/candidats-favoris/savejob.md): Ajoute une offre aux favoris du candidat
- [Retirer des favoris](https://docs.wethehivers.com/api-reference/candidats-favoris/unsavejob.md): Supprime une offre des favoris par ID de sauvegarde
- [Retirer des favoris par offre](https://docs.wethehivers.com/api-reference/candidats-favoris/unsavejobbyoffreid.md): Supprime une offre des favoris par ID d'offre
- [Ajouter une certification](https://docs.wethehivers.com/api-reference/candidats-profil/addcertification.md): Ajoute une nouvelle certification au profil
- [Ajouter un CV](https://docs.wethehivers.com/api-reference/candidats-profil/addcv.md): Ajoute un nouveau CV au profil du candidat
- [Changer le mot de passe](https://docs.wethehivers.com/api-reference/candidats-profil/changepassword-1.md): Change le mot de passe du candidat
- [Supprimer le compte](https://docs.wethehivers.com/api-reference/candidats-profil/deleteaccount.md): Supprime définitivement le compte du candidat
- [Supprimer une certification](https://docs.wethehivers.com/api-reference/candidats-profil/deletecertification.md): Supprime une certification du profil
- [Supprimer un CV](https://docs.wethehivers.com/api-reference/candidats-profil/deletecv.md): Supprime un CV du profil du candidat
- [Supprimer la photo](https://docs.wethehivers.com/api-reference/candidats-profil/deletephoto.md): Supprime la photo de profil du candidat
- [Récupérer le profil](https://docs.wethehivers.com/api-reference/candidats-profil/getprofile-1.md): Récupère le profil complet du candidat connecté
- [Définir CV par défaut](https://docs.wethehivers.com/api-reference/candidats-profil/setdefaultcv.md): Définit un CV comme CV par défaut
- [Mettre à jour la visibilité CV](https://docs.wethehivers.com/api-reference/candidats-profil/updatecvvisibility.md): Active ou désactive la visibilité du CV aux recruteurs
- [Mettre à jour les informations](https://docs.wethehivers.com/api-reference/candidats-profil/updateinformation.md): Met à jour les informations de base (nom, prénom, téléphone, pays, ville)
- [Mettre à jour la photo](https://docs.wethehivers.com/api-reference/candidats-profil/updatephoto.md): Met à jour la photo de profil du candidat
- [Mettre à jour les préférences de recherche](https://docs.wethehivers.com/api-reference/candidats-profil/updatesearchpreferences.md): Met à jour les métiers, localisations et types de contrat souhaités
- [Mettre à jour la situation](https://docs.wethehivers.com/api-reference/candidats-profil/updatesituation.md): Met à jour la situation professionnelle (statut, disponibilité, expérience, qualification, secteurs)
- [Mettre à jour les compétences](https://docs.wethehivers.com/api-reference/candidats-profil/updateskills.md): Met à jour la liste des compétences du candidat
- [Ajouter une note](https://docs.wethehivers.com/api-reference/candidatures/addnote.md): Ajoute une note à une candidature
- [Changer le statut](https://docs.wethehivers.com/api-reference/candidatures/changestatus-1.md): Change le statut d'une candidature
- [Vérifier si déjà postulé](https://docs.wethehivers.com/api-reference/candidatures/checkalreadyapplied.md): Vérifie si le candidat a déjà postulé à cette offre
- [Postuler à une offre](https://docs.wethehivers.com/api-reference/candidatures/createcandidature.md): Crée une nouvelle candidature pour une offre d'emploi
- [Supprimer ma candidature](https://docs.wethehivers.com/api-reference/candidatures/deletemycandidature.md): Supprime une candidature du candidat connecté (soft delete)
- [Candidatures d'une offre](https://docs.wethehivers.com/api-reference/candidatures/getcandidaturesbyoffre.md): Récupère toutes les candidatures d'une offre (avec filtre optionnel par statut)
- [Détails d'une candidature](https://docs.wethehivers.com/api-reference/candidatures/getcandidaturewithdetails.md): Récupère une candidature avec timeline et notes
- [Obtenir l'URL du CV](https://docs.wethehivers.com/api-reference/candidatures/getcvpresignedurl.md): Génère une URL présignée pour visualiser ou télécharger le CV du candidat (valide 15 min)
- [Détail de ma candidature](https://docs.wethehivers.com/api-reference/candidatures/getmycandidaturedetail.md): Récupère le détail d'une candidature avec timeline (sans notes privées)
- [Mes candidatures](https://docs.wethehivers.com/api-reference/candidatures/getmycandidatures.md): Récupère toutes les candidatures du candidat connecté
- [Candidatures récentes](https://docs.wethehivers.com/api-reference/candidatures/getrecentcandidatures.md): Récupère les dernières candidatures pour le dashboard
- [Refuser une candidature](https://docs.wethehivers.com/api-reference/candidatures/rejectcandidature.md): Refuse une candidature avec une raison
- [Supprimer un fichier](https://docs.wethehivers.com/api-reference/fichiers/deletefile.md): Supprime un fichier du stockage (admin uniquement)
- [Upload image article](https://docs.wethehivers.com/api-reference/fichiers/uploadarticleimage.md): Téléverse une image pour un article
- [Upload bannière entreprise](https://docs.wethehivers.com/api-reference/fichiers/uploadbanner.md): Téléverse la bannière d'une entreprise
- [Upload CV](https://docs.wethehivers.com/api-reference/fichiers/uploadcv.md): Téléverse un CV (PDF ou Word)
- [Upload fichier générique](https://docs.wethehivers.com/api-reference/fichiers/uploadgeneric.md): Téléverse un fichier (image ou document)
- [Upload image générique](https://docs.wethehivers.com/api-reference/fichiers/uploadgenericimage.md): Téléverse une image générique
- [Upload logo entreprise](https://docs.wethehivers.com/api-reference/fichiers/uploadlogo.md): Téléverse le logo d'une entreprise
- [Upload photo de profil](https://docs.wethehivers.com/api-reference/fichiers/uploadphoto.md): Téléverse une photo de profil (stockage public)
- [Upload photo staff](https://docs.wethehivers.com/api-reference/fichiers/uploadstaffphoto.md): Téléverse la photo d'un membre du staff
- [Archiver une offre](https://docs.wethehivers.com/api-reference/offres/archiveoffre.md): Archive une offre d'emploi (PUBLISHED → ARCHIVED)
- [Créer une offre](https://docs.wethehivers.com/api-reference/offres/createoffre.md): Crée une nouvelle offre d'emploi en mode DRAFT
- [Supprimer une offre](https://docs.wethehivers.com/api-reference/offres/deleteoffre.md): Supprime une offre d'emploi (soft delete)
- [Autocomplete recherche](https://docs.wethehivers.com/api-reference/offres/getautocompletesuggestions.md): Suggestions rapides pour la barre de recherche d'offres
- [Stats offres par ville](https://docs.wethehivers.com/api-reference/offres/getjobcountsbycity.md): Nombre d'offres publiées par ville (top villes)
- [Mes offres](https://docs.wethehivers.com/api-reference/offres/getmyoffres.md): Récupère toutes les offres du recruteur connecté (avec filtre optionnel par statut)
- [Récupérer une offre](https://docs.wethehivers.com/api-reference/offres/getoffre.md): Récupère une offre d'emploi par son ID
- [Statistiques d'une offre](https://docs.wethehivers.com/api-reference/offres/getoffrestats.md): Récupère les statistiques détaillées d'une offre avec breakdown des candidatures
- [Détail d'une offre publiée](https://docs.wethehivers.com/api-reference/offres/getpublishedoffre.md): Récupère le détail complet d'une offre publiée par son ID
- [Offres publiées](https://docs.wethehivers.com/api-reference/offres/getpublishedoffres.md): Récupère les offres publiées avec pagination (jobboard public, avec filtres optionnels)
- [Publier une offre](https://docs.wethehivers.com/api-reference/offres/publishoffre.md): Publie une offre d'emploi (DRAFT → PUBLISHED)
- [Recherche avancée d'offres](https://docs.wethehivers.com/api-reference/offres/searchpublishedoffres.md): Recherche paginée des offres publiées avec filtres avancés
- [Désarchiver une offre](https://docs.wethehivers.com/api-reference/offres/unarchiveoffre.md): Désarchive une offre d'emploi (ARCHIVED → PUBLISHED)
- [Mettre à jour une offre](https://docs.wethehivers.com/api-reference/offres/updateoffre.md): Met à jour une offre d'emploi (seulement si DRAFT)
- [Vue d'ensemble](https://docs.wethehivers.com/api-reference/overview.md): 172 endpoints groupés par module — index complet de l'API THE HIVE
- [Detail d'un article publie](https://docs.wethehivers.com/api-reference/public-blog/getarticlebyslug.md): Recupere le detail d'un article de blog publie par son slug
- [Lister les categories](https://docs.wethehivers.com/api-reference/public-blog/getcategories.md): Recupere la liste des categories distinctes des articles publies
- [Lister les articles publies](https://docs.wethehivers.com/api-reference/public-blog/getpublishedarticles.md): Recupere les articles de blog publies avec pagination et filtre optionnel par categorie
- [Détail d'une entreprise](https://docs.wethehivers.com/api-reference/public-entreprises/getentreprise.md): Récupère le détail complet d'une entreprise par son ID
- [Lister les entreprises](https://docs.wethehivers.com/api-reference/public-entreprises/getentreprises.md): Récupère la liste des entreprises qui recrutent (avec offres publiées)
- [Nombre d'offres d'une entreprise](https://docs.wethehivers.com/api-reference/public-entreprises/getoffrecount.md): Récupère le nombre d'offres publiées pour une entreprise
- [Statistiques du dashboard](https://docs.wethehivers.com/api-reference/recruteur-dashboard/getdashboardstats.md): Récupère les KPIs du recruteur pour le dashboard
- [getAllContractTypes](https://docs.wethehivers.com/api-reference/reference/getallcontracttypes.md)
- [getAllDepartements](https://docs.wethehivers.com/api-reference/reference/getalldepartements.md)
- [getAllNiveauxExperience](https://docs.wethehivers.com/api-reference/reference/getallniveauxexperience.md)
- [getAllPays](https://docs.wethehivers.com/api-reference/reference/getallpays.md)
- [getAllSecteursActivite](https://docs.wethehivers.com/api-reference/reference/getallsecteursactivite.md)
- [getPaysParDefaut](https://docs.wethehivers.com/api-reference/reference/getpayspardefaut.md)
- [getRegionById](https://docs.wethehivers.com/api-reference/reference/getregionbyid.md)
- [getRegionsByPays](https://docs.wethehivers.com/api-reference/reference/getregionsbypays.md)
- [getVilleById](https://docs.wethehivers.com/api-reference/reference/getvillebyid.md)
- [getVillesByPays](https://docs.wethehivers.com/api-reference/reference/getvillesbypays.md)
- [getVillesByRegion](https://docs.wethehivers.com/api-reference/reference/getvillesbyregion.md)
- [Ajouter candidat externe](https://docs.wethehivers.com/api-reference/vivier/addexternalcandidat.md): Ajoute un candidat externe au vivier
- [Ajouter candidat inscrit](https://docs.wethehivers.com/api-reference/vivier/addregisteredcandidat.md): Ajoute un candidat inscrit au vivier
- [Changer le statut](https://docs.wethehivers.com/api-reference/vivier/changestatus.md): Change le statut d'un candidat dans le vivier
- [Supprimer candidat](https://docs.wethehivers.com/api-reference/vivier/deletecandidat.md): Supprime un candidat du vivier
- [Détails candidat vivier](https://docs.wethehivers.com/api-reference/vivier/getcandidat.md): Récupère les détails d'un candidat du vivier
- [Candidats du vivier](https://docs.wethehivers.com/api-reference/vivier/getcandidatsvivier.md): Récupère tous les candidats du vivier avec filtres optionnels
- [Invitations du candidat](https://docs.wethehivers.com/api-reference/vivier/getinvitations.md): Récupère toutes les invitations envoyées à un candidat
- [Inviter un candidat](https://docs.wethehivers.com/api-reference/vivier/invitecandidat.md): Envoie une invitation à un candidat pour postuler sur une offre
- [Rechercher candidats](https://docs.wethehivers.com/api-reference/vivier/searchcandidats.md): Recherche des candidats par nom ou email
- [Toggle favori](https://docs.wethehivers.com/api-reference/vivier/togglefavorite.md): Marque/Démarque un candidat comme favori
- [Mettre à jour candidat](https://docs.wethehivers.com/api-reference/vivier/updatecandidat.md): Met à jour un candidat du vivier
- [Authentification](https://docs.wethehivers.com/authentication.md): Comment s'authentifier auprès de l'API THE HIVE avec JWT
- [Cycle de vie d'une offre](https://docs.wethehivers.com/concepts/cycle-de-vie-offre.md): États d'une offre d'emploi, transitions et règles métier
- [Cycle de vie d'un recruteur](https://docs.wethehivers.com/concepts/cycle-de-vie-recruteur.md): États d'un compte recruteur, validation admin et règles
- [Flow JWT et refresh](https://docs.wethehivers.com/concepts/jwt-refresh.md): Cycle complet access token / refresh token, blacklist, rotation
- [Recherche plein-texte](https://docs.wethehivers.com/concepts/recherche-plein-texte.md): Indexation tsvector, pondération, autocomplete et filtres
- [URLs pré-signées (R2 / S3)](https://docs.wethehivers.com/concepts/urls-presignees.md): Génération, durée de vie et révocation des URLs d'accès aux fichiers privés
- [Conventions](https://docs.wethehivers.com/conventions.md): Dates, devises, locales, noms de champs, formats
- [Collections API](https://docs.wethehivers.com/dx/collections.md): Exports Postman, Insomnia et Bruno prêts à l'emploi
- [FAQ développeur](https://docs.wethehivers.com/dx/faq.md): Questions fréquentes sur l'intégration API THE HIVE
- [Snippets Java / Spring Boot](https://docs.wethehivers.com/dx/snippets-java.md): RestTemplate, WebClient, OpenAPI codegen, retry, token manager
- [Snippets JavaScript / TypeScript](https://docs.wethehivers.com/dx/snippets-js.md): fetch, axios, client type-safe avec openapi-typescript
- [Snippets Python](https://docs.wethehivers.com/dx/snippets-python.md): requests, httpx, clients async, OpenAPI codegen, retry
- [Webhooks (à venir)](https://docs.wethehivers.com/dx/webhooks.md): Notifications HTTP sortantes pour événements THE HIVE
- [Énumérations](https://docs.wethehivers.com/enumerations.md): Toutes les valeurs énumérées utilisées par l'API
- [Environnements](https://docs.wethehivers.com/environnements.md): URLs et configuration par environnement (dev, staging, production)
- [Erreurs](https://docs.wethehivers.com/errors.md): Format des erreurs et codes HTTP renvoyés par l'API
- [Alertes emploi candidat](https://docs.wethehivers.com/guides/alertes-candidat.md): Créer, modifier, désactiver une alerte emploi par email
- [Administrer le blog](https://docs.wethehivers.com/guides/blog-admin.md): Rédiger, publier et modérer les articles du blog
- [Workflow admin](https://docs.wethehivers.com/guides/flow-admin.md): Validation des recruteurs, modération des offres et sanctions
- [Gérer son vivier](https://docs.wethehivers.com/guides/gestion-vivier.md): Créer un vivier, ajouter candidats inscrits ou externes, inviter
- [Inscription d'un recruteur](https://docs.wethehivers.com/guides/inscription-recruteur.md): Parcours complet d'inscription et de validation d'un compte recruteur
- [Publication d'une offre d'emploi](https://docs.wethehivers.com/guides/publication-offre.md): Comment créer, publier et gérer une offre d'emploi
- [Rechercher des offres](https://docs.wethehivers.com/guides/recherche-offres.md): Autocomplete, recherche plein-texte, filtres combinables
- [Upload de CV et de fichiers](https://docs.wethehivers.com/guides/upload-cv.md): Comment uploader CV, photo de profil et logo d'entreprise
- [Uploads médias](https://docs.wethehivers.com/guides/uploads-medias.md): Logos, bannières, photos staff, photos profil, covers blog
- [Workflow de candidature](https://docs.wethehivers.com/guides/workflow-candidature.md): Cycle de vie complet d'une candidature, de la soumission à la décision finale
- [Introduction](https://docs.wethehivers.com/introduction.md): THE HIVE API — Plateforme de recrutement et jobboard pour le Cameroun
- [Modèle AlerteEmploi](https://docs.wethehivers.com/models/alerte.md): Alertes candidats : critères, fréquences, matching, cron
- [Modèle Blog](https://docs.wethehivers.com/models/blog.md): Articles blog admin, catégories, publication SEO
- [Modèle Candidat](https://docs.wethehivers.com/models/candidat.md): Schéma du profil candidat, visibilité et relations
- [Modèle Candidature](https://docs.wethehivers.com/models/candidature.md): Schéma candidature, pipeline de statuts et événements
- [Modèle Entreprise](https://docs.wethehivers.com/models/entreprise.md): Schéma entreprise, RCCM, validations et médias
- [Modèle Offre](https://docs.wethehivers.com/models/offre.md): Schéma de l'offre d'emploi, indexation et contraintes
- [Modèle de données](https://docs.wethehivers.com/models/overview.md): Vue d'ensemble des entités et de leurs relations
- [Modèle Recruteur](https://docs.wethehivers.com/models/recruteur.md): Schéma du compte recruteur et rattachement entreprise
- [Modèle Vivier](https://docs.wethehivers.com/models/vivier.md): Bases de données candidats du recruteur
- [Pagination](https://docs.wethehivers.com/pagination.md): Comment parcourir les listes paginées de l'API
- [Rate limiting](https://docs.wethehivers.com/rate-limiting.md): Seuils, fenêtres, comportement et headers de rate limiting
- [Changelog API](https://docs.wethehivers.com/reference/changelog.md): Historique des changements de l'API THE HIVE
- [Données géographiques](https://docs.wethehivers.com/reference/donnees-geo.md): Régions, villes et quartiers du Cameroun utilisés par l'API
- [Rôles et permissions](https://docs.wethehivers.com/roles-permissions.md): Matrice des rôles, scopes d'accès et règles de contrôle
- [Versioning & changelog](https://docs.wethehivers.com/versioning.md): Politique de versioning, breaking changes et historique des versions

## OpenAPI Specs

- [openapi](https://docs.wethehivers.com/api-reference/openapi.json)

## Optional

- [GitLab](https://gitlab.com/the-hive5354847)