Aperçu de l'API

L'API WhenToMeet fournit un accès programmatique pour créer et gérer des événements de planification. Cette page couvre les prérequis et l'essentiel—pour une documentation complète des endpoints, des schémas de requête/réponse et des tests interactifs, visitez la Référence de l'API.

Démarrage rapide

1. Obtenir l'accès à l'API

L'API nécessite un abonnement Plus ou Plus Lifetime.

Voir les tarifs →

2. Créer une clé API

  1. Accédez à Paramètres → Clés API
  2. Cliquez sur "Créer une clé API"
  3. Donnez-lui un nom descriptif (par ex., "Serveur de production")
  4. Copiez la clé immédiatement – elle n'est affichée qu'une seule fois
  5. Stockez-la en toute sécurité (variables d'environnement, gestionnaire de secrets, etc.)

3. Explorer l'API

Visitez la Référence de l'API pour :

  • Parcourir tous les endpoints disponibles
  • Voir les schémas de requête/réponse
  • Tester les appels API de manière interactive
  • Voir des exemples de code

Authentification

Toutes les requêtes nécessitent un token Bearer :

Authorization: Bearer sk_votre_cle_api_ici

Sécurité de la clé API

À FAIRE :

  • Stocker les clés dans des variables d'environnement ou des gestionnaires de secrets
  • Utiliser des clés différentes pour dev/staging/production
  • Faire tourner les clés périodiquement
  • Révoquer immédiatement les clés compromises

À NE PAS FAIRE :

  • Committer les clés dans le contrôle de version
  • Partager les clés par e-mail ou chat
  • Intégrer les clés dans le code côté client
  • Réutiliser les clés sur plusieurs applications

Limites de taux

NiveauLimiteFenêtre
Gratuit32 requêtesTotal à vie
Plus1 000 requêtesPar heure (glissant)
Plus Lifetime1 000 requêtesPar heure (glissant)

En-têtes de limite de taux

Les réponses incluent :

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 847
X-RateLimit-Reset: 1736956800

En cas de limitation (réponse 429) :

  • Implémenter un backoff exponentiel
  • Vérifier X-RateLimit-Reset pour l'heure de réinitialisation
  • Surveiller X-RateLimit-Remaining pour limiter de manière proactive

Besoin d'aide ?

Was this page helpful?