Lister les Recharges Mobiles

Obtenir une liste paginée des transactions de recharge mobile

GET /v3/mobile/list

Lister les Recharges Mobiles

cURL

curl --request GET \
  --url https://api.oneclickdz.com/v3/mobile/list \
  --header 'X-Access-Token: <api-key>'

200

{
  "success": true,
  "data": {
    "items": [
      {}
    ],
    "pagination": {
      "page": 123,
      "pageSize": 123,
      "totalPages": 123,
      "totalResults": 123
    }
  },
  "meta": {
    "timestamp": "<string>"
  }
}

​

Vue d’Ensemble

Retourne une liste paginée de toutes les transactions de recharge mobile de votre compte avec filtrage optionnel par date.

​

Paramètres de Requête

page · integer · défaut: 1

Numéro de page (minimum : 1)

pageSize · integer · défaut: 20

Éléments par page (minimum : 1, maximum : 100)

from · string

Filtre de date de début (ISO 8601 : 2025-10-01T00:00:00Z)

to · string

Filtre de date de fin (ISO 8601 : 2025-10-31T23:59:59Z)

Les paramètres from et to doivent être fournis ensemble lors du filtrage par date.

​

Réponse

success · boolean · requis

Indique si la requête a réussi

data · object · requis

Afficher properties

items · array · requis

Tableau d’objets de recharge avec tous les détails, y compris le statut et les montants

pagination · object · requis

Afficher properties

page · integer

Numéro de page actuel

pageSize · integer

Nombre d’éléments par page

totalPages · integer

Nombre total de pages

totalResults · integer

Nombre total de recharges

meta · object · requis

Afficher properties

timestamp · string

Horodatage de la réponse au format ISO 8601

​

Exemples

cURL

curl https://api.oneclickdz.com/v3/mobile/list?page=1&pageSize=20 \
  -H "X-Access-Token: YOUR_API_KEY"

​

Exemple de Réponse

{
  "success": true,
  "data": {
    "items": [
      {
        "ref": "API-[phone]-test-1761698196315-suggest",
        "status": "REFUNDED",
        "plan_code": "PREPAID_DJEZZY",
        "MSSIDN": "0600000002",
        "topup_amount": 500,
        "balance_amount": 0,
        "created_at": "2025-10-29T00:36:36.385Z",
        "_id": "69016194e9e88196b4eb64ce",
        "refund_message": "هذا رقم الهاتف لا يقبل العرض المرسل، الرجاء إرسال أحد العروض التالية",
        "suggested_offers": [
          {
            "typename": "📋 FACTURE | فاتورة",
            "plan_code": "FACTURE_DJEZZY",
            "amount": 500
          }
        ]
      },
      {
        "ref": "API-[phone]-test-1761698159224-success",
        "status": "FULFILLED",
        "plan_code": "PREPAID_DJEZZY",
        "MSSIDN": "0778037340",
        "topup_amount": 500,
        "balance_amount": 0,
        "created_at": "2025-10-29T00:35:59.378Z",
        "_id": "6901616fe9e88196b4eb64b0"
      }
    ],
    "pagination": {
      "page": 1,
      "pageSize": 5,
      "totalPages": 72,
      "totalResults": 358
    }
  },
  "meta": {
    "timestamp": "2025-10-29T00:36:47.159Z"
  }
}

​

Cas d’Utilisation

Historique des Transactions

Affichez l’historique des recharges aux utilisateurs

Rapports et Analytiques

Générez des rapports de ventes et des statistiques

Réconciliation

Vérifiez les transactions et les variations de solde

Support Client

Recherchez les transactions des utilisateurs pour le support

​

Exemples de Filtrage

​

Par Plage de Dates

cURL

curl "https://api.oneclickdz.com/v3/mobile/list?from=2025-10-01T00:00:00Z&to=2025-10-31T23:59:59Z" \
  -H "X-Access-Token: YOUR_API_KEY"

​

Filtrage Côté Client

const { items } = data;

// Filter by status
const fulfilled = items.filter((t) => t.status === "FULFILLED");
const refunded = items.filter((t) => t.status === "REFUNDED");

// Filter by operator
const djezzy = items.filter((t) => t.plan_code.includes("DJEZZY"));

// Filter by amount range
const large = items.filter((t) => t.topup_amount >= 1000);

// Calculate totals
const totalAmount = items.reduce((sum, t) => sum + t.topup_amount, 0);
const totalCost = items.reduce((sum, t) => sum + t.balance_amount, 0);
const profit = totalAmount - totalCost;

​

Bonnes Pratiques

Pagination Efficace

• Utilisez des tailles de page raisonnables (20 à 50 éléments)
• Mettez les résultats en cache si possible
• Implémentez “Charger Plus” ou le défilement infini
• Utilisez pagination.totalPages pour déterminer s’il y a d’autres pages

Filtrage par Date

• Fournissez toujours les paramètres from et to ensemble - Utilisez le format ISO 8601 correct - Tenez compte du fuseau horaire de l’utilisateur lors du filtrage - Définissez des plages de dates raisonnables pour les performances

Performance

• Mettez en cache les données de liste pendant de courtes périodes - Utilisez des filtres de date pour limiter les ensembles de résultats - Évitez de récupérer toutes les pages à la fois - Indexez par created_at dans votre base de données locale

Affichage aux Utilisateurs

• Affichez le statut avec des icônes/couleurs
• Formatez les horodatages dans le fuseau horaire local
• Affichez les logos des opérateurs
• Liez vers des pages de statut détaillées
• Affichez la raison du remboursement pour les recharges échouées

​

Endpoints Associés

Envoyer une Recharge

Créer une nouvelle recharge

Vérifier le Statut

Suivre une recharge spécifique

Lister les Forfaits

Voir les forfaits disponibles