Quelles sont les limites de débit ?

À l’heure actuelle, nous n’appliquons pas de limites strictes de requêtes par seconde. Toutefois, une utilisation raisonnable est attendue afin de maintenir la qualité du service pour tout le monde.

Approche actuelle

Au lieu de limites strictes, nous encourageons une utilisation responsable :

• Espacer vos requêtes de manière raisonnable

• Mettre en place un backoff exponentiel en cas d’erreur

• Mettre en cache les réponses pour éviter les appels redondants

• Nous contacter si vous anticipez des volumes de trafic élevés

Bonnes pratiques

Mettre en cache de façon agressive :

• Conserver les résultats de recherche pour les requêtes courantes

• Garder les métadonnées des médias localement après récupération

• Ne pas appeler /confirm plusieurs fois pour le même utilisateur/ressource

Regrouper vos opérations :

• Regrouper les requêtes liées

• Ajouter de petites pauses entre les lots

• Limiter le nombre de connexions simultanées (10 à 20 est raisonnable)

Gérer les erreurs avec élégance :

• Mettre en place une logique de reprise avec backoff exponentiel

• Ne pas réessayer immédiatement en cas d’échec

• Consigner les erreurs pour le suivi

Temps de réponse attendus

• Recherche /resources : généralement 200-500 ms

• Détails /resource : moins de 100 ms

• /confirm licensing : 300-800 ms

Configurez le délai d’attente (timeout) de votre client sur au moins 30 secondes pour gérer occasionnellement des réponses plus lentes.

Si vous atteignez des limites

Vous recevrez une erreur 429 Too Many Requests. Lorsque cela se produit :

// Implement exponential backoff
async function fetchWithRetry(url, options, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      const response = await fetch(url, options);
      
      if (response.status === 429) {
        const waitTime = Math.pow(2, i) * 1000; // 1s, 2s, 4s
        await new Promise(resolve => setTimeout(resolve, waitTime));
        continue;
      }
      
      return response;
    } catch (error) {
      if (i === maxRetries - 1) throw error;
    }
  }
}

Surveillez votre utilisation

Suivez l’activité de l’API dans Paramètres → API :

• Voir le nombre total de requêtes effectuées

• Vérifier les licences actives

• Examiner les tendances d’utilisation

• Surveiller les schémas inhabituels

Besoin de limites plus élevées ?

Si votre utilisation légitime nécessite des volumes de requêtes élevés (> 1M requêtes/mois), contactez notre équipe pour discuter :

• Votre application et vos schémas de trafic

• Le volume de requêtes attendu

• Les limites de débit garanties si nécessaire