Authentification
Toutes les requêtes à l'API Reemite sont authentifiées par une clé API, transmise dans l'en-tête Authorization. Une clé est rattachée à votre compte business et donne accès à l'ensemble de ses ressources : conservez-la exclusivement côté serveur, jamais dans une application mobile ni dans un navigateur.
Obtenir une clé API
- Connectez-vous à votre Espace client.
- Ouvrez la section Clés API et générez une nouvelle clé.
- Copiez-la immédiatement : elle n'est affichée qu'une seule fois. Reemite n'en conserve qu'une empreinte et ne peut pas la retrouver pour vous.
:::info Compte activé requis En production, la génération de clés API est disponible une fois votre compte business vérifié et activé par l'équipe Reemite. La vérification se fait entièrement depuis l'Espace client.
En sandbox, le compte est actif dès l'inscription : vous pouvez générer une clé immédiatement. :::
Utiliser la clé
Transmettez la clé avec le schéma Bearer :
curl https://api.trustsend.africa/api/v1/business/wallet \
-H "Authorization: Bearer ts_live_xxxxxxxxxxxxxxxxxxxxxxxx"
La clé est vérifiée à chaque requête. Une clé révoquée est refusée dès l'appel suivant.
Environnements
Le préfixe de la clé indique l'environnement auquel elle appartient. Chaque environnement a sa propre URL, ses propres comptes et ses propres clés : une clé ne fonctionne que sur l'API de son environnement.
| Préfixe | Environnement | URL de base | Usage |
|---|---|---|---|
ts_sandbox_ | Sandbox | https://sandbox-api.trustsend.africa/api/v1 | Développement et tests d'intégration — voir Sandbox |
ts_live_ | Production | https://api.trustsend.africa/api/v1 | Opérations réelles |
Les clés émises avant le changement de préfixe (biz_sandbox_, biz_live_) restent valides.
Bonnes pratiques
- Stockez la clé dans une variable d'environnement ou un gestionnaire de secrets, jamais dans le code source.
- Utilisez une clé distincte par environnement et par service.
- En cas d'exposition, révoquez la clé depuis l'Espace client et générez-en une nouvelle.
Erreurs d'authentification
| Code | Message | Cause |
|---|---|---|
401 | Missing API key | En-tête Authorization absent ou mal formé |
401 | Invalid or revoked API key | Clé inconnue ou révoquée |
401 | This is a sandbox API key, but this is the production API. … | Clé sandbox envoyée à l'API de production |
401 | This is a live API key, but this is the sandbox API. … | Clé de production envoyée à l'API sandbox |
403 | Your current plan (…) does not include this feature: … | Fonctionnalité non incluse dans votre offre — voir Erreurs |