Scopes pour les clés API : chaque clé n'a que l'accès dont elle a besoin

Je suis heureux de vous présenter une nouveauté pour les clés API que vous créez dans le Dashboard. Jusqu'à aujourd'hui, chaque nouvelle clé avait un accès complet. Désormais, vous choisissez exactement ce que chaque clé peut faire au moment de la créer.

Nous vous présentons : les scopes pour les clés API

Comment ça marche ?

Quand vous créez une clé dans Account → Integrations → API keys, vous choisissez ses scopes (autorisations). Ils sont regroupés pour que vous les trouviez vite :

• Returns : de la consultation des retours et l'ajout de commentaires jusqu'à leur autorisation, leur contrôle, le changement du mode de remboursement ou leur annulation.
• Logistics : commandes, enlèvements, étiquettes, statut d'expédition et transporteurs.
• Analytics : taux de retour, rapports et insights sur les tailles.
• Store settings : conditions de retour et d'échange, branding, entrepôts et workflows.
• Credentials : les identifiants de votre plateforme et de vos transporteurs, signalés comme sensibles.

Chaque groupe a sa propre case à cocher, et Select all coche tous les scopes d'un coup. Vous ne savez pas ce que fait un scope ? What each scope allows, directement dans le formulaire, ouvre un guide qui explique chaque scope et liste ses endpoints.

Pourquoi c'est important ?

Chaque outil n'obtient que ce dont il a besoin : votre helpdesk peut consulter les retours et ajouter des commentaires, votre tableau de bord BI peut lire les analytics, et rien de plus. Nous recommandons une clé par intégration : si une clé fuite un jour, elle ne peut faire que ce que fait cette intégration, et vous pouvez la supprimer sans toucher aux autres. Un appel hors des scopes d'une clé est refusé, avec un message qui indique le scope manquant.

Que dois-je savoir d'autre ?

• Les clés existantes gardent un accès complet : les intégrations que vous avez déjà continuent de fonctionner comme avant.
• Les scopes ne sont pas modifiables : pour les changer, créez une nouvelle clé avec les bons scopes et supprimez l'ancienne.
• Pas d'accès complet depuis le Dashboard : Select all accorde tous les scopes proposés. Seul REVER peut émettre des clés avec un accès complet.

Quand puis-je l'utiliser ?

C'est disponible dès aujourd'hui, pour chaque nouvelle clé que vous créez. Si vous avez des questions, dites-le-nous.