Documentation de l’API

Connexion et utilisation de l’API Shifton

L’API Shifton vous donne accès à toutes les fonctionnalités clés de la plateforme — de la gestion des plannings aux intégrations avec des systèmes RH, de paie, et des systèmes d’analytique.
En utilisant l’API, vous pouvez automatiser les processus et connecter Shifton avec les services internes de votre entreprise.

Documentation de l’API

Nous soutenons deux versions de notre documentation :

• 📄 Ancienne Documentation — la version précédente de la référence API (toujours supportée pour les intégrations existantes) :
  👉 https://api2.shifton.com/docs/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/en/v1/

• 🚀 Nouvelle Documentation — la version actuelle de l’API avec une structure mise à jour et les dernières méthodes :
  👉 https://api2.shifton.com/openapi/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/

Premiers Pas

Obtenez une clé API

Dans les paramètres de votre entreprise sur la plateforme Shifton, générez une clé API.
L’autorisation se fait via l’en-tête :

Faites votre première requête

Par exemple, pour récupérer une liste d’employés :

Exemple de réponse :

Intégrez l’API dans vos workflows

• Créez et modifiez automatiquement les plannings

• Gérez les demandes de congés et d’arrêts maladie

• Exportez les données vers les systèmes de paie

• Créez des tableaux de bord et des rapports personnalisés

Fonctionnalités principales de l’API

• Employés – ajouter, modifier et gérer les rôles

• Horaires – créer, ajuster les shifts, planifier le travail

• Congés & Absences – gérer les demandes de congés et d’arrêt maladie

• Rapports – exporter les données de temps, de paie et de présence

Codes d’erreur

L’API Shifton utilise descodes d’état HTTP:

• 200 — Requête réussie

• 201 — Objet créé avec succès

• 400 — Paramètres invalides

• 401 — Erreur d’autorisation (clé API invalide)

• 403 — Accès refusé

• 404 — Ressource non trouvée

• 500 — Erreur du serveur

Conseils d’utilisation

• Utilisez toujours lanouvelle version de l’API pour les nouvelles intégrations

• Utilisez Postman ou curl pour tester

• Respectez les limites de taux pour éviter d’être bloqué

• Mettez à jour les intégrations qui dépendent encore de l’ancienne documentation