Développeurs / API
Une API ouverte et documentée pour relier Upikajob à vos outils
Plusieurs connexions sont déjà en service avec les solutions de grands éditeurs. Voici les caractéristiques techniques que votre DSI attend.
Fiche technique
L’essentiel en un coup d’œil
Les limites de requêtes et le détail des opérations figurent dans la documentation remise à l’activation.
| Caractéristique | API Upikajob, version 1 |
|---|---|
| Type | API REST |
| Documentation | Spécification OpenAPI 3, remise à l’activation |
| Authentification | Jeton Bearer, conservé côté serveur |
| Clé d’accès | Une clé par organisation, aux permissions limitées, révocable à tout moment |
| Format | JSON, listes paginées |
| Chiffrement | TLS 1.2 et plus |
| Synchronisation | Mode delta, avec resynchronisation complète possible |
| Volumes | Traitements par lots |
| Échange de fichiers | CSV, Excel ou JSON, en complément ou à la place de l’API |
| Connexion des utilisateurs | SSO SAML 2.0 ou OpenID Connect |
| Webhooks | Non disponibles en v1 |
Ressources
Les données accessibles par l’API
Chaque clé n’ouvre que les ressources nécessaires à votre flux. La lecture et l’écriture s’autorisent séparément.
Collaborateurs et hiérarchie
Identifiants, organisation et rattachements hiérarchiques.
Entretiens et synthèses
États et contenus des entretiens, selon les permissions de la clé.
Compétences et suivis
Référentiel, niveaux attendus et suivis du périmètre.
Formation
Catalogue, sessions, organismes et demandes.
Documents
Métadonnées des documents ; l’échange de fichiers se cadre à part.
Mise en place
Une intégration en quatre étapes
- Étape 1
Cadrage
Pour chaque donnée : l’outil de référence, le sens de l’échange, la fréquence et le responsable.
- Étape 2
Activation
Nous activons l’API pour votre organisation ; une personne habilitée crée la clé et ses permissions.
- Étape 3
Recette
Cinq situations testées : arrivée, changement de manager, erreur de format, départ, accès révoqué.
- Étape 4
Mise en service
Le flux passe en production, puis il est surveillé et maintenu.
Votre prochaine étape
Dites-nous quel outil vous utilisez.
Nous étudions votre environnement et vous confirmons la faisabilité sous 48 h.
