Passer au contenu principal
GET
/
v3
/
mobile
/
list
Lister les Recharges Mobiles
curl --request GET \
  --url https://api.oneclickdz.com/v3/mobile/list \
  --header 'X-Access-Token: <api-key>'
{
  "success": true,
  "data": {
    "items": [
      {}
    ],
    "pagination": {
      "page": 123,
      "pageSize": 123,
      "totalPages": 123,
      "totalResults": 123
    }
  },
  "meta": {
    "timestamp": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.oneclickdz.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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
​
meta
object
requis

​
Exemples

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-+213665983439-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-+213665983439-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 "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

  • 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
  • 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
  • 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
  • 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