# agent.txt — Aurélia.jobs
# Consignes d'intégration pour un agent logiciel.
# Version machine complète : https://aurelia.jobs/openapi.json

QUAND UTILISER CE SERVICE
  - Lire les offres d'emploi publiées par une entreprise qui recrute avec Aurélia.jobs, par API (`getPublicCareersJobs`) plutôt qu'en lisant la page carrière.
  - Déposer la candidature d'une personne sur une offre publiée, pièce jointe comprise (`submitPublicApplication`, `createJobpostingApplication`).
  - Synchroniser un flux d'offres vers un agrégateur ou un ATS partenaire (`listPublishedJobsJson`, `listPublishedJobsXml`).
  - Exercer les droits RGPD d'un candidat sur ses données : export ou demande d'effacement (`exportCandidateData`, `requestCandidateDeletion`).
  - Conduire la préqualification d'une candidature déjà déposée, quand le candidat y a consenti (`recordPrequalificationConsent`, puis les opérations de préqualification).
  - Répondre à une question sur l'entreprise éditrice, ses coordonnées ou ses engagements RGPD (`/api/public/v1/service-catalog`, `/fr/contact`, `/fr/privacy-policy`).

QUAND NE PAS L'UTILISER
  - Chercher un emploi sur l'ensemble du marché : Aurélia.jobs n'expose que les offres de ses clients, pas un index global.
  - Accéder au dossier d'un candidat, aux évaluations ou aux données d'un espace de travail : ces données sont cloisonnées par espace et ne sont accessibles à aucune API publique.
  - Créer un compte, un espace de travail ou un recrutement : ces actions passent par l'application, pas par l'API.

COMMENT COMMENCER
  1. Lire https://aurelia.jobs/api/public/v1/service-catalog (public, sans clé) : il
     liste les documents machine, les opérations et les portées.
  2. Charger https://aurelia.jobs/openapi.json pour les schémas de requête et de
     réponse, et pour générer des définitions d'outils.
  3. Pour un accès natif par outils, se connecter au serveur MCP :
     https://aurelia.jobs/api/mcp (Streamable HTTP), manifeste https://aurelia.jobs/mcp.json.

AUTHENTIFICATION
  - Public : catalogue de service, santé, offres d'une page carrière publique.
  - Clé workspace : en-tête X-API-Key, valeur ak_..., créée depuis l'espace de
    travail. Aucune création de clé en libre-service par API pour l'instant.
  - Clé Jobposting : en-tête X-API-Key, réservée à l'intégration partenaire.
  - Jeton candidat : présent dans l'URL du portail, à durée de vie courte,
    limité aux opérations RGPD du candidat concerné.
  - Portées déclarées au format RFC 9728 :
    https://aurelia.jobs/.well-known/oauth-protected-resource

FORMATS
  - Toutes les réponses sous /api/ sont en application/json, erreurs comprises.
  - Une erreur porte : error, code, message, hint, documentation_url, status.
  - Les pages publiques répondent en text/markdown si la requête envoie
    Accept: text/markdown.

CE QUE NOUS N'EXPOSONS PAS
  - Les données d'un espace de travail : candidats, évaluations, entretiens,
    messagerie. Elles sont cloisonnées par espace et hors API publique.
  - La création de compte, d'espace de travail ou de recrutement.

CONTACT
  - contact@aurelia.jobs
  - support@aurelia.jobs (support client)
  - 888 Route de la Caille, 74350 Allonzier-la-Caille, FR

OPÉRATIONS

  GET  /api/jobs.json
       operationId : listPublishedJobsJson
       auth        : en-tête X-API-Key (workspace)
       portées     : jobs:read
       objet       : Lister les offres publiées en JSON

  GET  /api/jobs.xml
       operationId : listPublishedJobsXml
       auth        : en-tête X-API-Key (intégration Jobposting)
       portées     : jobs:feed
       objet       : Lister les offres publiées en XML

  POST /api/candidatures
       operationId : createJobpostingApplication
       auth        : en-tête X-API-Key (intégration Jobposting)
       portées     : applications:write
       objet       : Recevoir une candidature Jobposting

  POST /api/v2/application/submit
       operationId : submitPublicApplication
       auth        : jeton candidat dans l'URL
       portées     : applications:write
       objet       : Soumettre une candidature publique V2

  POST /api/v2/prequalif/{sessionId}/consent
       operationId : recordPrequalificationConsent
       auth        : jeton candidat dans l'URL
       portées     : prequalification:write
       objet       : Enregistrer le consentement de préqualification

  POST /api/v2/prequalif/{sessionId}/stream
       operationId : streamPrequalificationConversation
       auth        : jeton candidat dans l'URL
       portées     : prequalification:write
       objet       : Streamer la conversation de préqualification

  POST /api/v2/prequalif/{sessionId}/save
       operationId : savePrequalificationState
       auth        : jeton candidat dans l'URL
       portées     : prequalification:write
       objet       : Sauvegarder l'état de préqualification

  GET  /api/v2/portal/{token}/export
       operationId : exportCandidateData
       auth        : jeton candidat dans l'URL
       portées     : candidate-portal:read
       objet       : Exporter les données candidat

  POST /api/v2/portal/{token}/delete
       operationId : requestCandidateDeletion
       auth        : jeton candidat dans l'URL
       portées     : candidate-portal:delete
       objet       : Demander la suppression des données candidat

  GET  /api/health
       operationId : getServiceHealth
       auth        : aucune (public)
       portées     : public:read
       objet       : Vérifier la santé du service

  GET  /api/public/v1/service-catalog
       operationId : getServiceCatalog
       auth        : aucune (public)
       portées     : public:read
       objet       : Lister les ressources lisibles par une machine

  GET  /api/public/v1/careers/{workspaceSlug}/jobs
       operationId : getPublicCareersJobs
       auth        : aucune (public)
       portées     : public:read
       objet       : Lister les offres d'une page carrière publique