API de soumission de candidats

Où le trouver

Administration → Intégrations → API de soumission de candidats

Qui peut l’utiliser

Administrateurs avec accès aux intégrations

URL directe

https://app.nextal.com/conf/admin/integrations

L’API de soumission de candidats permet à un partenaire d’intégration externe de soumettre un candidat et sa candidature à l’un de vos postes en un seul appel API — le candidat, son CV et la candidature sont créés d’un coup, sans enchaîner plusieurs requêtes. C’est ainsi qu’un babillard d’emplois partenaire, un site carrière tiers ou un agrégateur d’emplois peut acheminer les candidatures directement dans votre compte Nextal.

Vous gardez le contrôle : la capacité est désactivée par défaut, et seules les sources que vous autorisez explicitement peuvent soumettre. Une source est une clé d’intégration que vous remettez à votre partenaire; toute soumission provenant d’une source inconnue ou non autorisée est rejetée.

Ce que ça fait

Permet à un partenaire approuvé de créer un candidat et une candidature à un poste en un seul appel API.
Restreint les soumissions aux seules sources autorisées que vous listez — toute autre source est refusée.
Reste désactivée par défaut; rien n’est accepté tant que vous ne l’avez pas activée et ajouté au moins une source.
La correspondance des sources est insensible à la casse (partenaire et Partenaire sont traités de façon identique).

Prérequis

Un accès administrateur aux intégrations.
Une clé de source convenue avec votre partenaire d’intégration. C’est vous qui la choisissez (par exemple partenaire ou acme-emplois) et la communiquez au partenaire — c’est l’identifiant qu’il utilisera pour soumettre à votre compte.
Le partenaire doit disposer du contrat d’API (via le portail développeurs) pour construire ses soumissions.

Comment activer

Accédez à Administration → Intégrations et repérez la fiche API de soumission de candidats.
Cliquez sur Modifier pour ouvrir le panneau de configuration.
Activez le bouton Activer.
Sous Sources autorisées, ajoutez au moins une clé de source (voir ci-dessous).
Cliquez sur Enregistrer. La configuration est enregistrée immédiatement — il n’y a pas d’étape de publication distincte.

Gérer les sources autorisées

La liste des sources autorisées détermine précisément qui peut soumettre des candidats à votre compte.

Ajouter une source — saisissez la clé de source dans le champ d’ajout (par exemple partenaire), puis cliquez sur Ajouter la source (ou appuyez sur Entrée). Chaque source apparaît sur sa propre ligne.
Modifier une source — ajustez le texte directement dans le champ de la ligne correspondante.
Retirer une source — cliquez sur l’icône de suppression au bout de la ligne. Le partenaire correspondant ne pourra plus soumettre dès l’enregistrement.

Chaque clé de source doit avoir été provisionnée à votre partenaire au préalable : c’est exactement le segment que le partenaire indique dans sa requête. Seules les sources présentes dans cette liste sont autorisées; une soumission provenant d’une source absente est rejetée.

Paramètres

Paramètre	Description
Activer	Interrupteur principal de la capacité. Lorsqu’il est désactivé, aucune soumission par API n’est acceptée, quelles que soient les sources listées.
Sources autorisées	La liste des clés de source autorisées à soumettre des candidats à votre compte. Ajoutez-en autant que nécessaire; retirez celles qui ne doivent plus soumettre. La correspondance est insensible à la casse.

Conseils

Activer sans aucune source n’accepte rien. Si vous activez la capacité mais laissez la liste vide, aucun partenaire ne pourra soumettre. Ajoutez au moins une source pour que les soumissions fonctionnent.
Utilisez une clé de source par partenaire. Attribuer une clé distincte à chaque partenaire vous permet de révoquer l’accès de l’un sans affecter les autres — il suffit de retirer sa source de la liste.
Retirer une source coupe l’accès immédiatement. Dès l’enregistrement, toute soumission provenant de cette source est rejetée. C’est le moyen le plus rapide de suspendre un partenaire.
Traitez les clés de source comme des identifiants. Ne partagez une clé qu’avec le partenaire concerné et choisissez une valeur peu devinable si l’accès est sensible.
Désactiver la capacité suspend toutes les soumissions. La liste des sources est conservée; réactiver la capacité restaure l’accès pour toutes les sources listées.