API REST

L'API REST de Recrut'Auto expose les mêmes données que l'interface web et le serveur MCP, mais sous forme d'endpoints HTTP classiques. Elle est adaptée aux intégrations programmatiques : synchronisation ATS, webhooks, scripts, tableaux de bord BI.

Endpoint de base

L'URL de l'API dépend de l'environnement Recrut'Auto que vous utilisez :

• Environnement actuel (celui de cette documentation) : https://api.dev.recrutauto.fr

Authentification

Toutes les requêtes doivent inclure un Bearer token dans l'en-tête HTTP. Générez votre token depuis Tokens d'accès.

Authorization: Bearer ra_votre_token_ici

Exemples

Lister ses campagnes

curl https://api.dev.recrutauto.fr/api/campaigns/ \
  -H "Authorization: Bearer ra_votre_token_ici"

Récupérer une campagne

curl https://api.dev.recrutauto.fr/api/campaigns/42 \
  -H "Authorization: Bearer ra_votre_token_ici"

Récupérer un candidat enrichi

curl https://api.dev.recrutauto.fr/api/candidates/123/enriched \
  -H "Authorization: Bearer ra_votre_token_ici"

Rechercher des candidats

curl -X POST https://api.dev.recrutauto.fr/api/search/candidates \
  -H "Authorization: Bearer ra_votre_token_ici" \
  -H "Content-Type: application/json" \
  -d '{"query": "developpeur python", "page": 1, "size": 20}'

Codes d'erreur

Code	Signification
200	Succès
401	Token invalide ou révoqué
402	Aucun abonnement actif — souscrivez un plan
403	Permissions insuffisantes (rôle requis manquant)
404	Ressource introuvable ou hors périmètre de votre abonnement
429	Rate limit dépassé (60 requêtes/minute par défaut)
5xx	Erreur serveur — réessayez avec un backoff exponentiel

Rate limiting

L'API est limitée à 60 requêtes par minute par utilisateur. Au-delà, vous recevez un 429 Too Many Requests. Adaptez votre cadence en conséquence (backoff exponentiel recommandé).

Documentation OpenAPI

Le backend FastAPI expose automatiquement une documentation interactive :

• Swagger UI : https://api.dev.recrutauto.fr/docs
• ReDoc : https://api.dev.recrutauto.fr/redoc

Vous y trouverez la liste exhaustive des endpoints, schémas de requête/réponse, et pouvez tester directement depuis le navigateur (après avoir collé votre Bearer token).

Préférez le MCP pour les usages conversationnels

Si votre besoin est « parler à Claude pour créer une campagne », utilisez plutôt le serveur MCP — il abstrait les appels HTTP et fournit des prompts pré-configurés.