Environnements
Comprenez la différence entre les modes Test et Production pour le développement API.
Test vs Production
L'API Développeur Raba7ni prend en charge deux environnements pour vous aider à développer et déployer vos intégrations en toute sécurité :
| Fonctionnalité | Mode Test | Mode Production |
|---|---|---|
| Préfixe Clé API | test_ |
prod_ |
| Transactions | Réelles (crée des enregistrements réels) | Réelles |
| Notifications | Ignorées (log seulement) | Envoyées aux membres |
| Webhooks | Inclus le drapeau test: true |
Livraison normale |
| Limites de Fréquence | Limites du niveau Sandbox | Limites du niveau Payant |
URLs de Base API par Produit
Chaque produit API a son propre préfixe de route :
| Produit | URL de Base |
|---|---|
| ⭐ Points (Loyalty) | https://app.raba7ni.com/api/v1/loyalty/ |
| 🎟️ Tampons (Stamps) | https://app.raba7ni.com/api/v1/stamps/ |
| 💰 Cashback | https://app.raba7ni.com/api/v1/cashback/ |
Préfixes Clé API
Vous pouvez identifier l'environnement par le préfixe de la clé API :
X-Api-Key: test_sk_abc123def456...
X-Api-Key: prod_sk_xyz789ghi012...
Métadonnées de Réponse
Toutes les réponses API incluent un objet meta qui vous indique quel mode a été utilisé :
{
"success": true,
"data": { ... },
"meta": {
"mode": "test",
"request_id": "req_abc123"
}
}
Quand Utiliser Chaque Mode
Phase de Développement
Utilisez le Mode Test pendant la construction de votre intégration. Cela évite les notifications accidentelles aux vrais membres.
Staging/QA
Continuez à utiliser le Mode Test pour l'assurance qualité. Vérifiez meta.mode dans les réponses pour confirmer.
Lancement en Production
Passez aux clés Mode Production lorsque vous êtes prêt à passer en direct avec de vraies interactions membres.
Limitation Niveau Sandbox
Les partenaires sur le niveau gratuit Sandbox ne peuvent créer que des clés API Mode Test. Mettez à niveau vers un niveau payant pour accéder au Mode Production.
Création de Clés pour Chaque Environnement
[Capture d'écran : Modal de création de Clé API montrant le sélecteur d'environnement (Test/Production)]
Lors de la création d'une nouvelle clé API dans votre tableau de bord :
- Naviguez vers Développeur → Clés API
- Cliquez sur "Créer Clé API"
- Sélectionnez l'Environnement (Test ou Production)
- Choisissez les portées requises
- Cliquez sur Créer