L'API Playtomic Club permet aux propriétaires de clubs d'intégrer facilement leurs données de réservation avec des systèmes externes, rationalisant ainsi les opérations et améliorant l'expérience des membres. Ce guide complet couvre tout ce que tu dois savoir sur l'accès et l'utilisation de notre API.

Qu'est-ce que l'API Playtomic Club ?

L'API Playtomic Club est une interface sécurisée en lecture seule qui permet aux clubs d'accéder à leurs données de réservation de manière programmatique. Que tu exploites un seul site ou que tu gères plusieurs installations, l'API te permet de :

• S'intégrer avec des systèmes existants comme les CRM, les outils de marketing, les plateformes de fidélité ou les logiciels de gestion d'installations
• Accéder aux données de réservation en temps réel et historiques des 3 derniers mois
• Automatiser la synchronisation des données pour rationaliser les opérations du club

• Améliorer la communication avec les membres via des outils et plateformes externes

   

  📋 Note pour les clubs Syltek : Tu peux utiliser l'API avec la même visibilité des données que dans Manager. Bien que les réservations se synchronisent depuis Syltek, note que tous les éléments de l'emploi du temps (comme les cours) peuvent ne pas être synchronisés.

Qui peut accéder à l'API ?

L'accès à l'API est disponible pour :

• Clubs à un seul site avec des abonnements Champion ou Master
• Clubs multi-sites où chaque locataire a un abonnement Champion ou Master
• Propriétaires de chaînes qui obtiennent un accès unifié à toutes les données des clubs au sein de leur organisation

Fonctionnalités actuelles de l'API

Notre API en lecture seule offre un accès à des données de réservation complètes, y compris :

• ID de réservation et horodatages (format UTC)
• Informations sur le court (ID, nom)
• Détails des joueurs (IDs, email, préférences de communication)
• Informations de paiement
• Et bien plus encore (voir la spécification complète des données)

Fonctionnalités à venir

Nous développons activement l'API avec :

• Points de terminaison des données des joueurs (utilisant la même autorisation)
• Accès amélioré à l'historique des paiements
• Données détaillées sur les événements, activités et cliniques

Contacte ton gestionnaire de compte pour demander des fonctionnalités spécifiques ou exprimer ton intérêt pour les capacités à venir.

Commencer

1. Demander l'accès

1. Contacte ton gestionnaire de compte Playtomic ou le service client via le chat pour demander l'accès à l'API
2. Reçois tes identifiants via un lien sécurisé (valide pendant 3 jours, maximum 3 ouvertures)
3. Stocke les identifiants en toute sécurité - le lien temporaire expirera
4. Accède à la documentation et commence l'intégration

📄 Documentation complète de l'API (v1.1)

⚠️ Important : Sauvegarde immédiatement tes identifiants car le lien d'accès expire rapidement et ne peut pas être régénéré facilement.

2. Comprendre l'authentification

L'API utilise OAuth 2.0 pour un accès sécurisé :

Vos identifiants :

• ID client & Secret client : Identifiants uniques pour ton club/système
• Jeton d'accès : Identifiant temporaire (généralement valide pendant 1 heure) pour les appels API

Exemple de demande de jeton :

POST <https://api.playtomic.io/oauth/token>
Content-Type: application/json

{
  "client_id": "your_client_id",
  "client_secret": "your_client_secret",
  "grant_type": "client_credentials"
}

Effectuer des appels API :

GET <https://api.playtomic.io/v1/bookings>
Authorization: Bearer your_access_token

🔒 Meilleures pratiques de sécurité :

• Garde ton Secret client confidentiel
• Ne jamais exposer les identifiants dans des dépôts publics
• Implémente le renouvellement automatique des jetons dans tes systèmes

Spécifications et limitations des données

Gestion des fuseaux horaires

• Tous les horodatages sont en UTC - assure-toi que tes systèmes convertissent en fuseau horaire local
• Vérifie les paramètres de fuseau horaire de ton club dans Playtomic Manager > Paramètres > Infos du club

Disponibilité des données

• Données historiques : 90 derniers jours
• Réservations futures : Disponibles selon le calendrier
• Plage de requête maximale : 365 jours (90 passés + 275 futurs, ou 365 futurs)

Limites de taux

Les appels API sont soumis à des limites de taux (généralement 1 appel par minute) pour assurer la stabilité du système. Consulte la documentation pour connaître les limites actuelles.

Cas d'utilisation courants

Transforme les opérations de ton club avec ces intégrations populaires :

• Synchronisation CRM : Importe les données de réservation pour des campagnes marketing ciblées
• Analytique & Reporting : Analyse l'utilisation des courts et les fréquences des joueurs
• Communication avec les membres : Envoie des confirmations et rappels automatisés via des outils externes
• Gestion des installations : Intègre avec des serrures de porte intelligentes, l'éclairage ou d'autres systèmes IoT
• Programmes de fidélité : Suis l'activité des membres pour des programmes de récompenses et de rétention

Dépannage & Support

Obtenir de l'aide

• Responsable de compte : Évaluation de faisabilité et demandes d'accès
• Support technique : Dépannage API et assistance à l'intégration
• Documentation : Exemples complets, paramètres et descriptions des points de terminaison

Tester votre intégration

Bien que nous ne fournissions pas d'environnement de test séparé, tu peux tester en toute sécurité avec tes données de réservation réelles en utilisant des requêtes limitées pendant le développement.

Questions fréquemment posées (FAQ)

Authentification & Accès

Q : Comment obtenir des identifiants API ?

R : Contacte ton responsable de compte Playtomic ou l'équipe de support. Une fois approuvé, tu recevras un lien sécurisé (valide 3 jours, 3 ouvertures max) contenant ton ID Client et Secret Client.

Q : Que dois-je faire si je reçois des erreurs "Non autorisé" (401/403) ?

R : Solutions courantes :

• Vérifie que ton en-tête Authorization: Bearer token est inclus
• Vérifie si ton jeton d'accès a expiré (rafraîchis-le si nécessaire)
• Confirme que ton ID Client et Secret Client sont corrects

• Assure-toi de ne pas avoir dépassé les limites de taux

   

Q : Quelqu'un d'autre dans mon organisation peut-il demander de nouveaux identifiants ?

R : Oui, mais important : Les nouvelles demandes d'identifiants révoqueront les anciens. Partage les identifiants au sein de ton organisation pour éviter de perturber les intégrations existantes.

Accès aux données & Capacités

Q : Puis-je créer ou modifier des réservations via l'API ?

R : Non, l'API actuelle est en lecture seule. Tu peux récupérer et analyser les données de réservation mais tu ne peux pas créer, mettre à jour ou supprimer des réservations.

Q : Combien de données historiques puis-je accéder ?

R : Tu peux accéder aux données de réservation des 90 derniers jours plus toutes les réservations futures. La plage de requête maximale est de 365 jours au total.

Q : Dans quel fuseau horaire sont les horodatages de l'API ?

R : Tous les horodatages sont en UTC. Ton intégration doit les convertir dans ton fuseau horaire local. Vérifie que le fuseau horaire de ton club est correctement configuré dans Playtomic Manager.

Gestion multi-sites & chaînes

Q : En tant que propriétaire de chaîne, ai-je accès aux données de tous mes clubs ?

R : Oui ! Les propriétaires de chaînes reçoivent un accès unifié aux données de réservation de tous les clubs de leur organisation. Tu peux filtrer les requêtes pour des clubs spécifiques ou récupérer des données pour tous les emplacements.

Q : Tous les emplacements ont-ils besoin d'abonnements Champion/Master ?

R : Oui, pour un accès multi-sites, chaque locataire doit avoir un plan d'abonnement Champion ou Master.

Mise en œuvre technique

Q : À quelle fréquence puis-je appeler l'API ?

R : Des limites de taux sont en place (généralement 1 appel par minute) pour assurer la stabilité du système. Consulte la documentation pour connaître les limites actuelles et planifie ton intégration en conséquence.

Q : Puis-je tester l'API avant de la mettre en production ?

R : Bien qu'il n'y ait pas d'environnement de test séparé, tu peux tester en toute sécurité avec tes données de réservation réelles en utilisant des requêtes limitées pendant le développement.

Q : D'autres fonctionnalités seront-elles ajoutées à l'API ?

R : Oui ! Nous développons activement :

• Points de terminaison des données des joueurs (même autorisation)
• Historique des paiements amélioré
• Données détaillées sur les événements et les cliniques

Contacte ton responsable de compte pour demander des fonctionnalités spécifiques.

Support & Dépannage

Q : Quelles informations dois-je fournir lors d'une demande de support ?

R : Inclure :

• Message d'erreur complet
• Point de terminaison spécifique que tu appelais
• Ton ID de club

• Étapes que tu as déjà essayées

   

Q : Qui dois-je contacter pour différents types de problèmes ?

R :

• Demandes d'accès : Responsable de compte ou Service Client via chat pour demander l'accès à l'API
• Intégration technique : Équipe de support technique
• Demandes de fonctionnalités : Responsable de compte
• Facturation/abonnement : Responsable de compte

Besoin d'une assistance supplémentaire ? Contacte ton responsable de compte Playtomic ou notre équipe de Service Client pour une aide personnalisée avec ton intégration API.