Passer au contenu principal

​
Apercu

TXCloud implemente des limites de debit pour assurer une utilisation equitable et maintenir la stabilite de l’API. Les limites de debit varient selon le plan et le type d’endpoint.

​
Niveaux de Limites de Debit

PlanRequetes/MinuteRequetes/JourLimite de Burst
Gratuit601 00010
Starter30010 00050
Growth1 000100 000100
EnterprisePersonnalisePersonnalisePersonnalise
Limite de burst est le nombre maximum de requetes concurrentes autorisees.

​
Limites Specifiques par Endpoint

Certains endpoints ont des limites supplementaires :
EndpointLimiteFenetre
POST /identity/verify100/minPar cle API
POST /transactions/score1 000/minPar cle API
POST /watchlist/screen500/minPar cle API
GET /*/analytics/*30/minPar cle API

​
En-tetes de Limite de Debit

Chaque reponse API inclut des informations sur les limites de debit dans les en-tetes : 
HTTP/1.1 200 OK
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 950
X-RateLimit-Reset: 1705312800
X-RateLimit-Window: 60
En-teteDescription
X-RateLimit-LimitRequetes maximum autorisees dans la fenetre
X-RateLimit-RemainingRequetes restantes dans la fenetre actuelle
X-RateLimit-ResetTimestamp Unix de reinitialisation de la fenetre
X-RateLimit-WindowDuree de la fenetre en secondes

​
Gerer les Limites de Debit

Lorsque vous depassez la limite de debit, vous recevrez une reponse 429 Too Many Requests : 
{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Trop de requetes. Veuillez reessayer apres 30 secondes.",
    "type": "rate_limit_error",
    "retry_after": 30
  }
}

​
Implementer une Logique de Re-essai

async function makeRequestWithRetry(fn, maxRetries = 3) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    try {
      return await fn();
    } catch (error) {
      if (error.status === 429 && attempt < maxRetries - 1) {
        const retryAfter = error.headers['retry-after'] || 30;
        console.log(`Limite atteinte. Re-essai dans ${retryAfter}s...`);
        await sleep(retryAfter * 1000);
        continue;
      }
      throw error;
    }
  }
}

// Utilisation
const verification = await makeRequestWithRetry(() =>
  txcloud.identity.verify({ ... })
);

​
Bonnes Pratiques

Utilisez un backoff exponentiel pour les re-essais :
const delay = Math.min(1000 * Math.pow(2, attempt), 30000);
await sleep(delay);
Mettez en cache les reponses lorsque possible pour reduire les appels API :
  • Mettez en cache les resultats de verification par ID
  • Mettez en cache les profils de risque utilisateur
  • Mettez en cache les donnees de configuration
Utilisez les endpoints batch lorsque disponibles :
// Au lieu de plusieurs appels individuels
await txcloud.watchlist.screenBatch({
  entities: [entity1, entity2, entity3]
});
Suivez votre utilisation API dans le tableau de bord pour anticiper les problemes de limite de debit.

​
Augmenter Vos Limites

Besoin de limites de debit plus elevees ? Les options incluent :
  1. Passez a un plan superieur - Les plans superieurs ont des limites plus elevees
  2. Demandez une augmentation de limite - Contactez les ventes pour des limites personnalisees
  3. Optimisez votre integration - Reduisez les appels inutiles

Contacter les Ventes

Discutez des limites de debit personnalisees pour les besoins entreprise

​
Surveiller l’Utilisation

Suivez votre utilisation API dans le tableau de bord : 
// Obtenir votre utilisation actuelle
const usage = await txcloud.developers.usage.summary({
  period: '30d'
});

console.log('Total requetes:', usage.total_requests);
console.log('Limites atteintes:', usage.rate_limit_hits);
Configurez des alertes dans votre tableau de bord pour etre notifie lorsque vous approchez des limites de debit.