Skip to main content

​
Alertes emploi candidat

Un candidat inscrit peut enregistrer jusqu’à 5 alertes. Chaque alerte déclenche un email quotidien ou hebdomadaire avec les offres matchantes.

​
Flow utilisateur

​
1. Créer une alerte

POST /v1/api/candidats/me/alertes HTTP/1.1
Authorization: Bearer <CANDIDAT_TOKEN>
Content-Type: application/json

{
  "nom": "Java senior Douala",
  "criteres": {
    "query": "java spring",
    "typeContrat": ["CDI"],
    "niveauExperience": ["SENIOR"],
    "villeIds": [101],
    "salaireMin": 600000
  },
  "frequence": "DAILY"
}
Réponse 201 Created : 
{
  "id": 77,
  "nom": "Java senior Douala",
  "frequence": "DAILY",
  "active": true,
  "prochaineExecution": "2026-04-19T07:00:00Z"
}

​
2. Critères supportés

ChampTypeExemple
querystring"java spring"
secteurstring[]["SOFTWARE", "FINANCE"]
typeContratstring[]["CDI", "CDD"]
niveauExperiencestring[]["SENIOR", "INTERMEDIAIRE"]
villeIdslong[][101, 102]
salaireMinint500000
teletravailbooltrue

​
3. Lister mes alertes

GET /v1/api/candidats/me/alertes HTTP/1.1

{
  "alertes": [
    { "id": 77, "nom": "Java senior Douala", "active": true, "totalMatchs": 47 },
    { "id": 78, "nom": "React remote", "active": false, "totalMatchs": 12 }
  ]
}

​
4. Activer / désactiver

POST /v1/api/candidats/me/alertes/77/toggle HTTP/1.1

​
5. Modifier les critères

PATCH /v1/api/candidats/me/alertes/77 HTTP/1.1

{ "criteres": { "query": "java spring kafka", "typeContrat": ["CDI"] } }

​
6. Supprimer

DELETE /v1/api/candidats/me/alertes/77 HTTP/1.1

​
7. Désabonnement one-click (email)

Chaque email contient un lien signé permettant de désactiver sans login :

​
Fréquences

FréquenceCronUtilisation
DAILYTous les jours à 07:00Veille active
WEEKLYLundi à 07:00Veille passive

​
Limites

  • 5 alertes max par candidat inscrit
  • Anonyme : 0 alerte (besoin d’un compte)
  • Email envoyé uniquement si ≥ 1 match nouveau depuis lastRunAt
  • Top 10 offres dans l’email, lien vers la recherche complète

​
Exemple d’email reçu

Sujet : 3 nouvelles offres pour "Java senior Douala"

Bonjour Jean,

Voici les 3 nouvelles offres correspondant à votre alerte "Java senior Douala" :

1. Développeur Backend Java (H/F) — Tech Corp — Douala — CDI — 700k-900k XAF
2. Lead Developer Java — FinPlus — Douala — CDI — 1M-1.4M XAF
3. Ingénieur Backend Spring — DataFlow — Douala — CDI — 650k-850k XAF

[Voir toutes les offres]

— Désactiver cette alerte (en un clic)

​
Déduplication

Une offre notifiée une fois ne sera jamais renvoyée sur la même alerte, même si elle est modifiée.

​
Voir aussi