Portail développeur

Portail développeur#

L’API publique Shiftavo est une API REST de machine à machine. Un programme s’authentifie en tant qu’entreprise — pas en tant que personne — de sorte qu’une synchronisation nocturne de la paie tourne sans que personne ne reste connecté.

Ouvrir la référence de l’API →

Astuce

Chaque ressource, champ, méthode, scope et erreur est généré depuis l’API elle-même. La référence s’appuie sur un document OpenAPI 3.0 à l’adresse https://docs.shiftavo.com/api/openapi.json, que tu peux fournir à n’importe quel générateur de clients. Chaque shard sert également le schéma de la version qu’il exécute, à {api_base}/api/public/schema/.

Ce que tu peux construire#

  • Lire les plannings, les collaborateurs, les rapports d’heures, les demandes et soldes d’absence, les disponibilités, les règles de travail et le coût du travail.

  • Écrire les shifts et les assignations, les disponibilités, les corrections de rapports d’heures, les décisions d’absence, et la configuration de l’entreprise comme les sites, les postes et les types de contrat.

  • S’abonner aux webhooks pour que les changements te parviennent au fil de l’eau au lieu d’être interrogés.

CRUD complet, pas un export en lecture seule : POST pour créer, PATCH pour mettre à jour, DELETE pour supprimer, et POST vers un sous-chemin d’action pour les transitions de cycle de vie.

Ce qu’elle ne peut délibérément pas faire#

  • Te connecter en tant que personne. Seuls les identifiants d’intégration sont acceptés ; le login d’un collaborateur ne fonctionnera pas.

  • Atteindre une autre entreprise. Un jeu d’identifiants est lié à exactement une entreprise, côté serveur.

  • Lire des plannings non publiés. Les shifts en brouillon restent invisibles jusqu’à ce que l’équipe puisse les voir aussi.

  • Revendiquer ou attribuer des offres de la bourse aux shifts. Les shifts ouverts et les échanges sont en lecture seule ici — ces décisions restent aux personnes.

Pour commencer#

L’anatomie d’une intégration#

  1. Demande-nous des identifiants (voir Démarrage rapide). Tu reçois un client ID, un client secret et un ensemble de scopes.

  2. Échange-les auprès du fournisseur d’identité contre un jeton d’accès de courte durée.

  3. Lis le claim api_base de ce jeton — il nomme l’hôte à appeler. Ne code jamais un hôte de données en dur.

  4. Appelle {api_base}/api/public/v1/… avec Authorization: Bearer <token>.

Assistance#

Quelque chose n’est pas clair, ou il te manque un point de terminaison ? Écris à support@shiftavo.com et joins le X-Request-Id de la réponse dont tu parles — chaque réponse en porte un.