Cet article explique comment l'utilisation de l'API est facturée sur Easyship, ce qui est inclus dans votre forfait et comment surveiller votre utilisation dans votre tableau de bord.
Vue d'ensemble
Tous les forfaits d'abonnement Easyship incluent une allocation mensuelle d'appels API par point de terminaison. Vous ne payez un supplément que si vous dépassez votre limite incluse et même dans ce cas, votre accès n'est jamais bloqué.
Les points de terminaison suivants sont disponibles dans tous les forfaits :
- Validation d'adresse internationale
- Validation d'adresse nationale
- Suivi tiers
- Calculs des taxes et droits
- Calcul du code SH
- Tarifs
Limites incluses
Chaque forfait comprend un nombre défini d'appels API par point de terminaison et par mois. Votre allocation est réinitialisée à la date de renouvellement de votre abonnement chaque mois.
Ce qui compte dans votre limite : Seuls les appels API réussis sont comptabilisés. Les requêtes échouées ne sont ni comptées ni facturées.
Clients Enterprise : L'utilisation de l'API est suivie mais non facturée.
Frais de dépassement
Si vous dépassez votre limite incluse pour un point de terminaison, des frais de dépassement par appel vous seront facturés pour l'utilisation supplémentaire. Votre accès n'est jamais bloqué — votre intégration continue de fonctionner et les frais de dépassement sont ajoutés à votre prochaine facture mensuelle. Notez qu'une carte de paiement valide doit être enregistrée pour que cela s'applique.
Les limites de taux standard s'appliquent toujours à tous les forfaits pour garantir la stabilité du système.
Cycle de facturation
Les frais d'utilisation de l'API sont facturés mensuellement et correspondent à votre date de renouvellement d'abonnement.
- Forfaits mensuels : facturés à votre date de renouvellement chaque mois
- Forfaits annuels : l'utilisation de l'API est toujours facturée mensuellement, pas annuellement
Exemple : Si vous vous êtes inscrit le 2 juin avec un forfait annuel, votre utilisation de l'API sera facturée le 2 de chaque mois.
Abonnés annuels : votre facture mensuelle d'utilisation de l'API est distincte de votre frais d'abonnement annuel.
Portées de l'API
Les portées définissent à quels points de terminaison et fonctionnalités une connexion API a accès. Certaines portées sont contrôlées par l'utilisateur, tandis que d'autres sont gérées par Easyship.
Lors de la configuration d'une intégration API, vous choisirez entre deux versions de l'API :
- 2023-01 ou antérieure (héritée) : Les portées sont listées sans actions spécifiques — activer une portée donne un accès en lecture et écriture à tous les points de terminaison pertinents dans cette portée.
- 2024-09 ou ultérieure (recommandée) : Les portées utilisent le format <scope>.<resource>:<action> (par ex. public.address:read). Cela vous offre un contrôle plus granulaire.
Comment créer une intégration API
- Connectez-vous à votre compte Easyship sur app.easyship.com
- Cliquez sur Nouvelle intégration sous Connecter dans la barre latérale
- Cliquez sur Intégration API en bas de la page
- Remplissez les informations et sélectionnez votre version API préférée
- Cliquez sur Connecter
Comment voir ou modifier les portées
- Connectez-vous à votre compte Easyship sur app.easyship.com
- Sélectionnez votre connexion API sous l'onglet Connecter dans la barre latérale
- Sous Jeton d'accès API, vous pouvez voir à quelles portées le jeton a accès
- Pour effectuer des modifications, cliquez sur Modifier, sélectionnez ou désélectionnez les portées selon vos besoins, puis cliquez sur Enregistrer
Si vous avez besoin d'accéder à des portées supplémentaires pour des fonctionnalités avancées ou des fonctionnalités en version bêta, contactez votre responsable de compte ou contactez-nous via Support Easyship.
Consulter votre utilisation
- Connectez-vous à votre compte Easyship
- Allez dans Abonnement dans les paramètres de votre compte
- Sélectionnez l'onglet Utilisation de l'API
Vous y verrez :
- Tous les points de terminaison disponibles dans votre forfait
- Appels utilisés vs. votre limite incluse par point de terminaison
- Frais de dépassement accumulés pour la période en cours
- Appels API utilisés ventilés par connexion API individuelle
- Quelles plateformes sont connectées et quelles API sont actives
Les données d'utilisation se rafraîchissent environ toutes les 15 minutes.
Comprendre votre facture
Les frais d'utilisation de l'API apparaissent en tant que lignes sur votre facture mensuelle, avec une ventilation détaillée montrant :
- Appels API par point de terminaison
- Utilisation incluse vs. dépassement
- Total des frais par point de terminaison
Pour consulter vos factures, allez dans Abonnement > Facturation dans les paramètres de votre compte.
FAQ
Mon accès sera-t-il bloqué si j'atteins ma limite ?
Non. Votre intégration continue de fonctionner sans interruption. Les frais de dépassement pour tout appel au-delà de votre limite incluse apparaîtront sur votre prochaine facture mensuelle.
Suis-je notifié lorsque je m'approche de ma limite ?
Oui. Vous recevrez des alertes à 90 % et 100 % de votre utilisation incluse pour chaque point de terminaison.
Je suis sur un forfait annuel — pourquoi reçois-je des frais mensuels ?
Les frais d'utilisation de l'API sont facturés mensuellement, quel que soit votre type d'abonnement. Ils sont distincts de votre frais d'abonnement annuel et apparaîtront comme des lignes distinctes chaque mois.
Que se passe-t-il si je rétrograde mon forfait ?
Vos limites API incluses seront ajustées immédiatement au niveau de votre nouveau forfait. Si vous utilisiez des portées disponibles uniquement dans un niveau supérieur, vous perdrez l'accès à ces portées. Une nouvelle période de facturation commence avec votre nouveau forfait.
Les clients Enterprise paient-ils pour l'utilisation de l'API ?
Non. L'utilisation de l'API Enterprise est suivie pour la visibilité mais n'est pas facturée.
J'ai besoin de plus d'appels API que ce que mon forfait inclut. Quelles sont mes options ?
Si votre utilisation dépasse régulièrement les limites incluses de votre forfait, envisagez de passer à un abonnement supérieur. Si les forfaits standards ne répondent pas à vos besoins en volume, contactez notre équipe — nous pouvons créer un forfait personnalisé adapté à vos exigences.
Que se passe-t-il si je n'ai pas de méthode de paiement enregistrée ?
Une méthode de paiement valide est requise pour accéder aux points de terminaison payants. Si aucune n'est enregistrée, vous verrez l'erreur : "Méthode de paiement requise pour l'accès aux points de terminaison payants." Ajoutez une méthode de paiement dans vos paramètres de facturation pour rétablir l'accès.
Que se passe-t-il si le paiement de mon abonnement échoue ?
Si votre paiement échoue, l'accès aux points de terminaison payants peut être restreint. Mettez à jour votre méthode de paiement dans les paramètres de facturation et réessayez le paiement, ou contactez notre équipe de support pour obtenir de l'aide.