L'intégration
Accès programmatique complet à vos données d'embauche. Créer des emplois, tirer les scores des candidats, synchroniser des pipelines et créer des flux de travail personnalisés. Disponible sur le plan Pro (50 $ par mois).
Le Curriculo ATS REST API fournit un accès programmatique complet à vos données d'embauche, permettant aux équipes de créer des emplois, de récupérer les scores des candidats, de gérer les étapes du pipeline et de créer des intégrations personnalisées avec HRIS, les outils de paie et de reporting. Le API utilise des conventions standard REST avec des réponses JSON, une authentification des clés API et des événements webhook pour des mises à jour en temps réel. Disponible sur le plan Pro à 50 $ par mois, sans frais par demande dans les limites des tarifs.
Capacités API
CRUD pour les emplois et les candidats
Créer, lire, mettre à jour et supprimer des emplois et des candidats de manière programmatique. Publier de nouvelles offres d'emploi à partir d'outils internes, mettre à jour en masse les étapes des candidats et synchroniser les profils des candidats avec les systèmes externes. Les opérations CRUD complètes sur toutes les ressources de base.
Scores et données de pipeline
Retrouvez les scores d'impact (0100) et les ventilations de dimensions pour chaque candidat. Demandez les étapes du pipeline, suivez la progression des candidats et tirez des mesures d'embauche agrégées pour les tableaux de bord et les rapports personnalisés.
Les événements Webhook
Abonnez-vous à des événements de webhook en temps réel: nouvelle demande reçue, candidat marqué, changement d'étape, offre envoyée, candidat embauché. Chaque connexion Web fournit une charge utile JSON avec le contexte complet de l'événement à votre point final.
Export en vrac
Exporter en vrac les données des candidats, les résultats du score et les instantanés du pipeline. Tirez tous les candidats à un poste, tous les scores sur les rôles ou l'historique complet du pipeline pour les exigences de conformité et de déclaration.
Utilisation des cas
Synchronisation avec HRIS & Payroll
Lorsqu'un candidat est marqué comme étant embauché dans Curriculo ATS, appuyez automatiquement son profil sur votre HRIS (BambooHR, Rippling, etc.) ou votre système de paie (Gusto, ADP). Éliminer l'entrée manuelle des données entre l'embauche et l'intégration.
Dashboards d'analyse personnalisés
Retirez les mesures d'embauche via le API et créez des tableaux de bord personnalisés dans votre outil de choix BI, Looker, Metabase ou Google Sheets. Suivre le temps de location, la qualité de la source, la répartition des scores et les taux de conversion de l'entonnoir.
Posting automatique des emplois
Créez des offres d'emploi dans Curriculo ATS de manière programmatique à partir de vos outils internes ou de votre site de carrière CMS. Lorsque votre équipe ouvre un nouveau rôle, le API crée le travail, définit des critères de notation et active automatiquement le pipeline.
Enrichissement des données sur les candidats
Utilisez des webhooks pour déclencher des flux de travail d'enrichissement lorsque de nouveaux candidats postulent. Retirez des données supplémentaires de Clearbit, LinkedIn ou de vos propres bases de données, puis écrivez des profils enrichis à Curriculo ATS via le API.
Technique
Limites de taux d'authentification et de
1L'authentification de la clé API
Générez une clé API à partir de votre tableau de bord Curriculo ATS dans Paramètres > API. Inclure la clé dans l'en-tête Autorisation de chaque demande. Les clés peuvent être rotées à tout moment sans perturber les intégrations actives.
2Limits de taux
Les limites de fréquence standard sont de 100 demandes par minute par clé API. Le API renvoie 429 codes d'état lorsque les limites sont dépassées, avec une en-tête Retry-After indiquant quand réessayer. Des limites plus élevées sont disponibles sur le plan Enterprise.
3Documentation
La documentation complète de API est disponible sur le portail de développement Curriculo ATS pour les abonnés au plan Pro. Inclut un explorateur interactif API, des exemples de code dans cURL, Python, Node.js et Ruby, ainsi que des outils de test de connexion Web.
Code Exemple
Créez une nouvelle liste d'emplois avec un seul appel API.
# Create a new job listing
curl -X POSThttps://api.curriculo.me/v1/jobs \
-H"Authorization: Bearer YOUR_API_KEY" \
-H"Content-Type: application/json" \
-d'{
"title": "Senior Backend Engineer",
"department": "Engineering",
"location": "Remote",
"employment_type": "full_time",
"description": "Build and scale our API infrastructure...",
"scoring_criteria": {
"role_fit_weight": 40,
"outcomes_weight": 35,
"context_weight": 25
}
}'FAQ
Questions fréquemment posées
Le API est libre ?
Le REST API est disponible sur le plan Pro à 100 $ par mois (50 $ par mois pour les premiers oiseaux). Le plan Pro comprend des appels API illimités dans les limites de tarifs, des événements de webhook et un accès complet à la documentation.
Y a-t-il des limites de taux ?
- Je sais. Les limites de fréquence standard sont de 100 demandes par minute par clé API. Le API renvoie un code d'état 429 avec une en-tête Retry-After lorsque les limites sont dépassées. Des limites plus élevées sont disponibles sur le plan Enterprise.
Le API prend en charge les webhooks ?
- Je sais. Curriculo ATS envoie des événements webhook pour des actions clés: nouvelle demande, candidat marqué, changement de scène, offre envoyée et candidat embauché. Configurez les points d'extrémité de la connexion Web dans vos paramètres de tableau de bord.
Où puis-je trouver la documentation API ?
La documentation complète de API sera disponible lors du lancement sur le portail de développement Curriculo ATS. Les abonnés au plan Pro ont accès à des documents interactifs API, des exemples de code en plusieurs langues et des outils de test de connexion Web.