Commencer

Avant de Commencer

Avant de démarrer l'intégration, assurez-vous de bien comprendre les points suivants :

• Compte Partenaire Requis - Vous avez besoin d'un compte partenaire Raba7ni actif
• Niveau Développeur - Choisissez entre les niveaux Sandbox (gratuit, mode test) ou Production
• Clés API - Vous générerez des clés avec des portées spécifiques pour la sécurité

Étapes d'Intégration

1

Créez Votre Application

Connectez-vous à votre tableau de bord partenaire et accédez à la section Développeur. Créez une nouvelle application pour recevoir votre ID d'application et votre secret d'application.

Environnement	URL du Tableau de Bord
Sandbox (test)	https://app.raba7ni.com/fr-fr/partner/developer
Production	https://app.raba7ni.com/fr-fr/partner/developer

2

Générez des Clés API

Créez des clés API avec les portées appropriées pour votre intégration. Choisissez uniquement les permissions dont votre application a besoin pour une meilleure sécurité.

Bonne Pratique de Sécurité

Ne demandez que les portées dont votre application a réellement besoin. Cela limite les dommages potentiels si une clé est compromise.

3

Faites Votre Première Requête

Utilisez votre ID d'Application et votre Clé API pour vous authentifier et commencer à faire des requêtes vers nos points de terminaison.

API Produit

Cette page utilise l'API Loyalty. Pour d'autres APIs, consultez la documentation Cashback ou Coins.

bash

curl -X POST "https://app.raba7ni.com/api/v1/loyalty/members/validate" \
  -H "X-App-Id: app_votre_id_application" \
  -H "X-Api-Key: prod_votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{"card_id": 5, "phone_number": "+21612345678"}'

4

Gérez la Réponse

Toutes les réponses API suivent un format JSON cohérent. Vérifiez le champ success pour déterminer si la requête a réussi.

Réponse de Succès

{
  "success": true,
  "data": {
    "is_member": true,
    "validated_at": "2025-01-15T10:30:00Z"
  },
  "meta": {
    "mode": "test",
    "request_id": "req_abc123"
  }
}

Étapes Suivantes

Maintenant que vous avez fait votre première requête, explorez ces sujets pour approfondir votre intégration :