Utilisation, fiabilité et traitement des données
Comprenez les unités, niveaux, erreurs, nouvelles tentatives, identifiants, durées de conservation et l’activation hors ligne.
Unités, niveaux et cycles de facturation
Une unité de base couvre jusqu’à 1.000 points de code Unicode par texte, arrondis séparément au supérieur, avec un minimum d’une unité. Le niveau API applique son coefficient. Les fractions sont conservées en dixièmes d’unité.
| Niveau | Coefficient d’unité | Limite des requêtes natives |
|---|---|---|
| Standard | 1,0 | 64 textes · 200.000 points de code par texte |
| Batch | 0,5 | 200 textes · 200.000 points de code par texte |
| Real-Time | 1,6 | 4 textes · 4.000 points de code par texte |
Par exemple, deux textes de 800 caractères consomment 2 unités Standard, 1 unité Batch ou 3,2 unités Real-Time. Batch natif est un niveau de traitement moins prioritaire ; les tâches Azure asynchrones ont un cycle distinct.
Le quota du forfait est utilisé avant les packs. Le quota mensuel est réinitialisé à chaque cycle, sans report. Les packs n’expirent pas. Une montée en gamme payée ouvre un nouveau cycle avec le quota complet ; baisse ou résiliation prennent effet en fin de période. Vérifiez le montant dans le tableau de bord avant confirmation.
Consultez votre consommation dans Tableau de bord ou GET /v1/usage. Le portail de facturation fournit les factures PDF, les coordonnées de l’entreprise et les moyens de paiement. Les taxes applicables sont calculées au paiement et les factures envoyées par e-mail après achat.
Erreurs et nouvelles tentatives
Les erreurs de l’API native utilisent {"error":{"code":"…","message":"…"}}. Les points de terminaison compatibles Azure utilisent leurs propres formats d’erreur. Conservez X-Request-Id pour le diagnostic.
| État | Action |
|---|---|
| 401 | Vérifiez la clé, son état de révocation et l’environnement. |
| 402 | Ajoutez des unités ; l’erreur indique les quantités nécessaires et disponibles. |
| 403 | Vérifiez que le forfait inclut le niveau demandé. |
| 413 / 422 | Corrigez l’entrée ou divisez la requête dans les limites documentées. |
| 429 | Respectez Retry-After, puis réessayez avec un délai croissant et aléatoire. |
| 503 | Défaillance temporaire du service. Respectez Retry-After si présent. |
Les erreurs de validation et les requêtes rejetées avant traitement ne consomment pas d’unités. Une coupure de connexion ne prouve pas l’échec : conservez la référence et vérifiez la consommation avant de relancer un gros traitement. Les résultats synchrones ne sont pas conservés pour relecture.
Traitement des données et clés
Les textes synchrones et correspondances sont traités en mémoire. Les journaux de consommation contiennent des identifiants, volumes et durées, pas le contenu des documents. Les entrées et résultats asynchrones nécessitent un stockage temporaire chiffré et expirent après 24 heures. Votre application gère la conservation des résultats et correspondances reçus.
Créez et révoquez les clés API dans le tableau de bord. Starter autorise une clé ; les forfaits supérieurs jusqu’à cinq. Les clés de production commencent par shr_live_, celles du bac à sable par shr_test_. Elles appartiennent à des environnements distincts. Ne les intégrez pas dans des applications navigateur, URL ou messages d’assistance.
Activation hors ligne
