API liste appels entrants Airtel Prepaid : format requête & paramètres
Pour récupérer programmatiquement historique détaillé appels entrants compte Airtel prepaid via API, utiliser structure requête JSON suivante. Typiquement utilisé partenaires enterprise, systèmes facturation, ou apps self-care avec autorisation appropriée.
Format requête API (JSON)
{ "requestInfo": { "apiOperationName": "GetAirtelPrepaidIncomingCallList", "accountNumber": "your_account_number" } }Définitions champs
| Champ | Type | Requis | Description |
|---|---|---|---|
requestInfo | Object | Oui | Wrapper métadonnées opération. |
apiOperationName | String | Oui | Valeur fixe : "GetAirtelPrepaidIncomingCallList". Identifie opération API spécifique. |
accountNumber | String | Oui | Numéro mobile Airtel prepaid (MSISDN) ou ID compte pour liste appels demandée. Format : 91XXXXXXXXXX (Inde) ou format local par cercle. |
Payload réponse typique (Illustratif)
{ "responseInfo": { "status": "SUCCESS", "timestamp": "2024-05-20T14:30:00Z" }, "callRecords": [ { "callingNumber": "+919876543210", "calledNumber": "+919123456789", "callStartTime": "2024-05-20T10:15:22Z", "callDurationSeconds": 145, "callType": "VOICE", "circle": "DEL", "roamingStatus": "HOME" } // ... more records ] }Notes implémentation critiques
- Authentification : API requiert OAuth 2.0 / JWT token header Authorization (Bearer token). Obtenir via Portail Partenaire Airtel / API Gateway.
- Limites taux : Throttling strict (ex: 10 req/min/compte). Implémenter backoff exponentiel.
- Rétention données : CDR (Call Detail Records) généralement dispo 6–12 mois régulations TRAI.
- Vie privée/Conformité : Accès requiert consentement explicite abonné ou mandat légal (règles divulgation CDR). DPDP Act 2023 s'applique.
- Environnement : Utiliser endpoints sandbox/UAT tests. Endpoints production requièrent app certifiée onboardée.
- Alternative : Pour utilisateurs finaux, App Airtel Thanks > « Utilisation » > « Historique appels » ou USSD
*121*7#fournit données sans intégration API.
API destinée partenaires B2B autorisés et systèmes internes. Clients individuels utiliser app Airtel Thanks ou USSD historique appels personnel.