API Staff & Go
L'API Staff & Go permet à une application partenaire de lire et d'écrire les données RH de Staff & Go pour le compte d'une société cliente, en REST et — pour les agents IA — en MCP. Chaque capacité est exposée sous ces deux formes à partir d'une définition unique : un outil et un endpoint se comportent donc toujours à l'identique.
Par où commencer
| Démarrage rapide | Obtenir des identifiants et réussir un premier appel authentifié. |
| Référence de l'API | Tous les endpoints, leurs paramètres et leurs réponses. Le scope de chacun est dans le guide de son thème. |
| Changelog | Tous les changements du contrat publié, générés depuis le contrat lui-même (en anglais). |
Guides
| Authentification | OAuth 2.0 client credentials, scopes, et le jeton legacy déprécié. |
| Découverte | Ce que votre profil et les référentiels vous disent avant tout autre appel, et comment vous resynchroniser. |
| Sociétés, salariés et contrats | Les établissements, les personnes, les contrats — et les champs retirés faute de droit accordé. |
| Congés et soldes | Les absences, ce qui reste sur chaque compteur, et pourquoi le motif est retiré par défaut. |
| Temps travaillé | Les journées enregistrées face au planning, et pourquoi un null n'y est pas un zéro. |
| Paie | Clôtures, bulletins et éléments variables — et là où les montants ne sont pas. |
| Notes de frais et titres restaurant | Les demandes ligne à ligne, les devises à ne pas additionner, et les décomptes sur lesquels on commande. |
| Exports en masse | Demander un domaine entier sous forme de fichier, et ce qu'implique la fenêtre de sept jours. |
| Erreurs | Le contrat Problem Details, les types d'erreur, et ce qu'il faut réessayer. |
| Idempotence | Idempotency-Key : rendre sûr le réessai d'une écriture. |
| Limites de débit | Quotas de plan, en-têtes RateLimit, et traitement du 429. |
| Journal d'audit | Relire les appels que vous avez passés, et répondre à une demande RGPD. |
| Webhooks | Enregistrer une URL, vérifier la signature, gérer les réessais. |
| Versionnement | Ce que nous garantissons dans une version, et comment la dépréciation est annoncée. |
| Cycle de vie | Beta contre GA, et le garde-fou beta:access. |
| Agents IA (MCP) | Utiliser les mêmes capacités sous forme d'outils MCP. |
| SDK clients | Les clients générés C#, TypeScript et Python, et ce qu'ils laissent à votre charge. |
Bac à sable
Intégrez d'abord sur l'environnement staging. Il fait tourner le même code et le même contrat que la production, avec ses propres identifiants et ses propres données : rien de ce que vous y faites n'affecte une paie réelle.
Votre interlocuteur Staff & Go vous communique l'adresse de staging et vos identifiants de bac à sable.