API Elenco Chiamate in Entrata Airtel Prepagato: Formato e Parametri della Richiesta
Per recuperare a livello di programmazione un dettagliato storico delle chiamate in entrata per un account Airtel prepagato tramite API, usa la seguente struttura di richiesta JSON. Ciò è tipicamente usato da partner aziendali, sistemi di fatturazione o app self-care con autorizzazione adeguata.
Formato della Richiesta API (JSON)
{ "requestInfo": { "apiOperationName": "GetAirtelPrepaidIncomingCallList", "accountNumber": "your_account_number" } }Definizioni dei Campi
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
requestInfo | Oggetto | Sì | Wrapper per i metadati dell'operazione. |
apiOperationName | Stringa | Sì | Valore fisso: "GetAirtelPrepaidIncomingCallList". Identifica l'operazione API specifica. |
accountNumber | Stringa | Sì | Il numero di telefono mobile Airtel prepagato (MSISDN) o ID account per cui si richiede l'elenco chiamate. Formato: 91XXXXXXXXXX (India) o formato locale per cerchia. |
Payload di Risposta Tipico (Illustrativo)
{ "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" } // ... più record ] }Note di Implementazione Critiche
- Autenticazione: Questa API richiede token OAuth 2.0 / JWT nell'intestazione Authorization (Bearer token). Ottienilo tramite Airtel Partner Portal / API Gateway.
- Rate Limits: Applicazione di throttling rigoroso (es. 10 req/min/account). Implementa esponential backoff.
- Conservazione Dati: I CDR (Call Detail Records) sono tipicamente disponibili per 6–12 mesi per regolamenti TRAI.
- Privacy/Conformità: L'accesso richiede consenso esplicito dell'abbonato o mandato legale (regole di divulgazione CDR). DPDP Act 2023 si applica.
- Ambiente: Usa endpoint sandbox/UAT per test. Gli endpoint di produzione richiedono onboarding app certificato.
- Alternativa: Per utenti finali, la Airtel Thanks App > "Usage" > "Call History" o USSD
*121*7#forniscono questi dati senza integrazione API.
Questa API è destinata a partner B2B autorizzati e sistemi interni. I singoli clienti dovrebbero usare l'app Airtel Thanks o USSD per lo storico chiamate personale.