# Aurélia.jobs

> Plateforme SaaS de gestion du recrutement pour les recruteurs professionnels et les PME : préparation d'un recrutement, diffusion d'offres, suivi des candidatures, préqualification par IA et espace candidat.

Aurélia.jobs est éditée par AURELIA.JOBS (888 Route de la Caille, 74350 Allonzier-la-Caille, FR).
Contact : contact@aurelia.jobs.

## Quand utiliser Aurélia.jobs

- 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 utiliser Aurélia.jobs

- 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 nous appeler

- [openapi.json](https://aurelia.jobs/openapi.json): spécification OpenAPI 3.1 complète, un operationId par appel.
- [service-catalog](https://aurelia.jobs/api/public/v1/service-catalog): découverte en un appel, sans authentification.
- [mcp.json](https://aurelia.jobs/mcp.json): manifeste du serveur MCP, transport Streamable HTTP sur https://aurelia.jobs/api/mcp.
- [agent.txt](https://aurelia.jobs/agent.txt): consignes d'intégration détaillées.
- [oauth-protected-resource](https://aurelia.jobs/.well-known/oauth-protected-resource): portées déclarées, au format RFC 9728.

## Opérations

- [listPublishedJobsJson](https://aurelia.jobs/openapi.json): GET /api/jobs.json — Lister les offres publiées en JSON. Authentification : en-tête X-API-Key (workspace). Portées : jobs:read.
- [listPublishedJobsXml](https://aurelia.jobs/openapi.json): GET /api/jobs.xml — Lister les offres publiées en XML. Authentification : en-tête X-API-Key (intégration Jobposting). Portées : jobs:feed.
- [createJobpostingApplication](https://aurelia.jobs/openapi.json): POST /api/candidatures — Recevoir une candidature Jobposting. Authentification : en-tête X-API-Key (intégration Jobposting). Portées : applications:write.
- [submitPublicApplication](https://aurelia.jobs/openapi.json): POST /api/v2/application/submit — Soumettre une candidature publique V2. Authentification : jeton candidat dans l'URL. Portées : applications:write.
- [recordPrequalificationConsent](https://aurelia.jobs/openapi.json): POST /api/v2/prequalif/{sessionId}/consent — Enregistrer le consentement de préqualification. Authentification : jeton candidat dans l'URL. Portées : prequalification:write.
- [streamPrequalificationConversation](https://aurelia.jobs/openapi.json): POST /api/v2/prequalif/{sessionId}/stream — Streamer la conversation de préqualification. Authentification : jeton candidat dans l'URL. Portées : prequalification:write.
- [savePrequalificationState](https://aurelia.jobs/openapi.json): POST /api/v2/prequalif/{sessionId}/save — Sauvegarder l'état de préqualification. Authentification : jeton candidat dans l'URL. Portées : prequalification:write.
- [exportCandidateData](https://aurelia.jobs/openapi.json): GET /api/v2/portal/{token}/export — Exporter les données candidat. Authentification : jeton candidat dans l'URL. Portées : candidate-portal:read.
- [requestCandidateDeletion](https://aurelia.jobs/openapi.json): POST /api/v2/portal/{token}/delete — Demander la suppression des données candidat. Authentification : jeton candidat dans l'URL. Portées : candidate-portal:delete.
- [getServiceHealth](https://aurelia.jobs/openapi.json): GET /api/health — Vérifier la santé du service. Authentification : aucune (public). Portées : public:read.
- [getServiceCatalog](https://aurelia.jobs/openapi.json): GET /api/public/v1/service-catalog — Lister les ressources lisibles par une machine. Authentification : aucune (public). Portées : public:read.
- [getPublicCareersJobs](https://aurelia.jobs/openapi.json): GET /api/public/v1/careers/{workspaceSlug}/jobs — Lister les offres d'une page carrière publique. Authentification : aucune (public). Portées : public:read.

## Portées

- `jobs:read`: Lire les offres publiées d'un espace de travail (export JSON).
- `jobs:feed`: Lire le flux d'offres XML destiné aux agrégateurs partenaires.
- `applications:write`: Déposer une candidature sur une offre publiée, depuis un partenaire ou une page carrière.
- `prequalification:write`: Conduire la préqualification d'une candidature : consentement, conversation, sauvegarde.
- `candidate-portal:read`: Exporter les données personnelles rattachées à une candidature (droit d'accès RGPD).
- `candidate-portal:delete`: Demander l'effacement des données rattachées à une candidature (droit à l'effacement RGPD).
- `public:read`: Lire les ressources publiques sans authentification : catalogue de service, offres d'une page carrière publique, santé du service.

## Documents

- [openapi](https://aurelia.jobs/openapi.json): Spécification OpenAPI 3.1 de toute la surface API publique, avec un operationId et des schémas typés par opération.
- [openapi-yaml](https://aurelia.jobs/openapi/aurelia-v2-openapi.yaml): Même spécification, en YAML.
- [service-catalog](https://aurelia.jobs/api/public/v1/service-catalog): Point d'entrée de découverte : documents machine, opérations publiques, portées et éditeur.
- [llms](https://aurelia.jobs/llms.txt): Présentation du produit pour un modèle de langage, avec la section « quand nous appeler ».
- [agent-instructions](https://aurelia.jobs/agent.txt): Consignes d'intégration destinées aux agents : cas d'usage, authentification, limites.
- [mcp-manifest](https://aurelia.jobs/mcp.json): Manifeste du serveur MCP : transport, URL, outils exposés et authentification.
- [protected-resource-metadata](https://aurelia.jobs/.well-known/oauth-protected-resource): Métadonnée RFC 9728 : portées supportées et méthodes de présentation du jeton.
- [sitemap](https://aurelia.jobs/sitemap.xml): Toutes les URL publiques indexables.
- [robots](https://aurelia.jobs/robots.txt): Règles de crawl, robots d'IA compris.

## Pages de référence

- [Documentation API](https://aurelia.jobs/fr/api): la même surface, expliquée pour un humain.
- [À propos](https://aurelia.jobs/fr/a-propos): qui édite le service.
- [Contact](https://aurelia.jobs/fr/contact): coordonnées et informations légales.
- [Politique de confidentialité](https://aurelia.jobs/fr/privacy-policy): traitements de données et droits RGPD.
- [Mentions légales](https://aurelia.jobs/fr/legal): identité de l'éditeur et hébergement.
- [Conditions générales](https://aurelia.jobs/fr/terms): conditions d'utilisation du service.