Jetons Bearer
Envoyez votre clé sous la forme Authorization: Bearer VOTRE_CLE sur chaque requête. Les clés sont indépendantes de votre connexion Careersome et n'expirent pas d'elles mêmes.
Une API publique et des webhooks pour les offres d'emploi, les employés, le suivi du temps, les candidatures, les congés et la structure de l'organisation. Disponible sur les forfaits Professionnel et Entreprise.
Tout le parcours se déroule depuis votre tableau de bord, sans compte développeur séparé.
L'accès à l'API publique est inclus dans ces forfaits. Si vous êtes sur Starter ou en essai gratuit, mettez d'abord à niveau depuis les paramètres de l'organisation.
Rendez vous dans les paramètres de l'organisation, ouvrez l'onglet Développeurs, et créez une clé. Choisissez uniquement les périmètres nécessaires, par exemple jobs:read pour synchroniser un tableau d'offres.
Envoyez votre clé comme jeton Bearer dans l'en tête Authorization de toute requête vers l'un des points de terminaison ci dessous.
Enregistrez une URL et les types d'événements qui vous intéressent, et Careersome livrera des charges signées à votre point de terminaison au fur et à mesure.
Les clés sont affichées une seule fois, à leur création. Conservez la vôtre comme n'importe quel autre identifiant de production.
Envoyez votre clé sous la forme Authorization: Bearer VOTRE_CLE sur chaque requête. Les clés sont indépendantes de votre connexion Careersome et n'expirent pas d'elles mêmes.
Une clé ne fonctionne que pour les ressources qui lui ont été accordées à sa création, comme jobs:read ou time_off:read. Ne demandez que ce dont une intégration a réellement besoin.
Révoquez une clé depuis l'onglet Développeurs à tout moment. La révocation prend effet immédiatement sur la requête suivante.
Chaque clé dispose de sa propre limite de requêtes par minute, indiquée dans l'en tête de réponse X-RateLimit-Remaining, afin qu'une intégration n'affecte pas les autres.
Chaque réponse est automatiquement limitée à votre entreprise. La pagination utilise les paramètres limit et offset. Cliquez sur un point de terminaison pour voir un exemple de requête et de réponse.
Enregistrez une URL cible et les types d'événements souhaités, depuis l'onglet Développeurs.
Un nouvel enregistrement d'employé a été créé.
Un candidat a changé d'étape sur une de vos offres.
Une demande de congé a été approuvée.
Un employé a soumis des entrées de temps pour validation.
Chaque livraison inclut un en tête X-Careersome-Signature, un HMAC de la charge utilisant votre secret webhook, afin que vous puissiez vérifier qu'elle provient bien de Careersome. Les livraisons échouées sont automatiquement retentées avec des délais croissants.