Noter une offre

Ce qui existe côté serveur

Le serveur contient déjà deux points d'accès pour lancer et suivre une évaluation payante. Ils exigent un utilisateur connecté et un solde de jetons suffisant.

Lancer une évaluation

POST /api/agents/evaluate-offer

{
  "offerId": "<identifiant de l'offre (UUID)>",
  "cv": "<texte du CV>",
  "targetRoles": ["…"]
}

• L'en-tête Idempotency-Key rend un nouvel essai sans danger : la même clé ne facture ni ne lance jamais deux fois.
• Réponse 202 avec jobId, service, state, charged (jetons débités), remaining (solde restant) et replayed.
• Réponse 402 si le solde est insuffisant.

Suivre l'évaluation

GET /api/agents/jobs/{jobId}

Renvoie l'état de l'exécution, les jetons débités, refunded (vrai si une exécution échouée a été remboursée), l'éventuelle erreur et, une fois terminée, le result.

Ce qui n'est pas encore prêt

• l'ouverture de ces points d'accès aux utilisateurs, avec la connexion et la session gérées par le serveur ;
• la capacité evaluations du SDK, qui encapsulera ces deux appels ;
• le format définitif du rapport (exigences, verdicts, citations), décrit dans Notation et génération de CV.

Tant que ce n'est pas publié, ne bâtissez pas d'intégration sur ces points d'accès : leur forme peut changer.