Accès aux API Cumino
Les API Cumino ne sont pas en libre-service : l'accès est ouvert par locataire après examen du cas d'usage et signature du DPA. Envoyez la demande, nous répondons avec des identifiants sandbox.
Ce que vous pouvez faire avec les API
Les API exposent les mêmes données et les mêmes actions que la plateforme, pour les amener dans les outils que vous utilisez déjà.
Candidats
Lisez les fiches, les résultats de présélection et les transcriptions d'appels, et renvoyez l'état d'avancement depuis votre ATS.
Campagnes
Créez des campagnes, publiez des postes et récupérez les candidatures collectées via WhatsApp, Telegram et QR codes.
Offres publiques
La liste des postes publiés est déjà exposée sans authentification : c'est l'endpoint qui alimente les pages /lavoro, vous pouvez donc republier les offres sur votre propre site.
Authentification
L'accès est lié à un seul locataire et passe par le service d'authentification Cumino. Les identifiants sont nominatifs et révoqués sur demande.
De la demande à la production
Quatre étapes. Les délais dépendent surtout de la revue du traitement des données.
Vous envoyez la demande
Vous décrivez ce que vous voulez intégrer, avec quels volumes et depuis quel système. Cela détermine les permissions dont vous avez réellement besoin.
Nous évaluons et signons le DPA
Nous vérifions le cas d'usage et fixons les rôles et la base légale du traitement. Si vous êtes déjà client, le DPA est souvent en place.
Vous recevez les identifiants sandbox
Un environnement séparé avec des données de test, pour développer et vérifier sans toucher aux candidats réels.
Vous passez en production
Une fois l'intégration validée, nous activons le jeton de production avec les limites convenues.
Ce qu'il faut savoir
Authentification Bearer
Chaque appel porte un jeton dans l'en-tête Authorization. Les jetons sont liés au locataire et ne se partagent pas entre environnements.
Limites d'appel
Les limites sont convenues par intégration, selon les volumes déclarés dans la demande, et communiquées avec les identifiants.
Données personnelles
L'API traite des données de candidats : un DPA en vigueur et une finalité documentée sont requis avant la remise des identifiants.
Demander l'accès
Nous répondons à l'adresse indiquée ici. Les champs techniques nous permettent de préparer les bons identifiants dès le premier échange.
Où se trouve la documentation technique
La référence avec les endpoints, le format des réponses et des exemples est fournie avec les identifiants sandbox : elle décrit ainsi toujours l'environnement que nous avons ouvert pour vous, et non une version hypothétique.