Skip to main content

​
AlerteEmploi

Une alerte emploi est un filtre sauvegardé par un candidat pour recevoir par email les nouvelles offres matchantes.

​
Schéma

​
Structure des critères

{
  "query": "développeur java",
  "secteur": ["SOFTWARE", "FINANCE"],
  "typeContrat": ["CDI", "CDD"],
  "niveauExperience": ["INTERMEDIAIRE", "SENIOR"],
  "villeIds": [101, 102],
  "salaireMin": 500000,
  "teletravail": true
}

​
Flow de matching

​
Exemple JSON de réponse

{
  "id": 77,
  "nom": "Java senior Douala",
  "criteres": {
    "query": "java spring",
    "typeContrat": ["CDI"],
    "niveauExperience": ["SENIOR"],
    "villeIds": [101]
  },
  "frequence": "DAILY",
  "active": true,
  "lastRunAt": "2026-04-18T07:00:12Z",
  "totalMatchs": 47,
  "prochaineExecution": "2026-04-19T07:00:00Z"
}

​
Email d’alerte

​
Désabonnement

Chaque email contient un lien one-click avec un token signé qui désactive l’alerte sans login : 
GET /v1/api/alertes/unsubscribe?token=eyJ...

​
Limites

Plan candidatAlertes maxFréquences
Inscrit gratuit5DAILY + WEEKLY
Anonyme0—

​
Endpoints principaux

MéthodePathDescription
GET/v1/api/candidats/me/alertesListe alertes
POST/v1/api/candidats/me/alertesCréer
PATCH/v1/api/candidats/me/alertes/{id}Modifier critères
DELETE/v1/api/candidats/me/alertes/{id}Supprimer
POST/v1/api/candidats/me/alertes/{id}/toggleActiver/désactiver
GET/v1/api/alertes/unsubscribeLien email

​
Déduplication

Une offre déjà notifiée pour une alerte ne sera pas renvoyée (table alerte_matches avec index unique (alerteId, offreId)). 
CREATE UNIQUE INDEX uq_alerte_match ON alerte_matches(alerte_id, offre_id);