Nous recommandons aux clients et aux développeurs de s’entretenir au préalable et de s’accorder sur les spécifications techniques avant de signer pour le développement d’une intégration avec Broadbean.
Merci de bien vouloir prendre en compte les exigences suivantes lors de la conception de l’interface :
- L’interface doit accepter une annonce par transaction
- L’interface doit supporter le multithreading au cas où plusieurs transactions soient exécutées en simultané
- Chaque transaction doit pouvoir traiter une nouvelle adresse email unique, spécifique à chaque annonce, que nous utilisons pour pouvoir suivre les candidatures dans Broadbean. Les candidatures sont ensuite envoyées dans la boite de réception du recruteur
- Tout doublon de candidature par un même candidat à une même annonce est bloqué par nos soins, nous aurons ainsi besoin de l’adresse email du candidat envoyée dans le champ « From » de la candidature ou dans le champ « Reply-To » de l’adresse.
- Lorsque l’utilisateur inclut un lien vers le site d’une entreprise, l’interface doit supporter une nouvelle URL unique. La plupart de nos clients directs préfèrent que les candidats postulent via un formulaire sur leur site. Lorsque c’est le cas, le champ correspondant contiendra cette URL. Celle-ci doit être utilisée lorsqu’elle est présente. Dans le cas contraire, les candidatures doivent être envoyées à l’adresse email fournie
- Dans le cas d’une erreur, l’API doit renvoyer un message spécifique (et non un message d’erreur générique), par exemple “identifiants incorrects” ou bien “Crédits insuffisants”, etc. Le message d’erreur ne doit pas contenir le code de l’erreur, qui serait incompréhensible par l’utilisateur.
Les données seront transférées à votre interface dans un format spécifique. Vous avez cependant la possibilité de choisir ce format. Ce choix vous est laissé car chaque site a des spécifications techniques différentes.
Cet exemple de XML peut être utilisé comme base puis adapté lorsque cela est nécessaire. Vous pouvez également utiliser des champs sur mesure si besoin.