Générer votre clé
Rendez-vous dans Réglages, puis Accès API. Un bouton génère votre clé.
Elle ne s'affiche qu'une seule fois : nous n'en gardons qu'une empreinte, personne chez nous ne peut la relire, et c'est aussi ce qui garantit que personne d'autre ne le pourra. Copiez-la immédiatement dans votre gestionnaire de secrets. Ensuite, l'écran n'en montre plus que les cinq derniers caractères, de quoi reconnaître laquelle est en place.
Si vous la perdez, régénérez : la précédente cesse de fonctionner à l'instant même.
Choisir ses autorisations
Au moment de générer, vous décidez si la clé peut écrire. Sans cette case, elle ne peut que lire.
Ce choix compte si vous confiez la clé à un agent ou à un script que vous n'avez pas écrit : une clé en lecture seule ne peut pas modifier un prix plancher. Nous vous conseillons de commencer par là, et de n'accorder l'écriture que le jour où vous en avez l'usage.
Votre premier appel
La clé se présente dans un en-tête Authorization. Toutes les réponses sont en JSON.
curl -H "Authorization: Bearer swp_votre_cle" \
https://api.sweeprice.com/v1/productsCe que répondent les erreurs
Les refus sont distincts, parce qu'ils appellent des gestes différents.
- 401 : la clé est inconnue ou absente. Vérifiez l'en-tête, régénérez si besoin.
- 403 : la clé est bonne mais votre formule n'inclut pas l'API, votre abonnement n'est pas actif, ou la clé n'a pas l'autorisation d'écriture.
- 429 : votre allocation mensuelle est épuisée, ou vous appelez trop vite. Levez le pied, ne régénérez pas.