API de lista de llamadas entrantes prepago de Airtel: Formato de solicitud y parámetros

Para recuperar programáticamente un historial detallado de llamadas entrantes para una cuenta prepago de Airtel mediante API, utiliza la siguiente estructura de solicitud JSON. Esto es típicamente usado por socios empresariales, sistemas de facturación o aplicaciones de autoservicio con la autorización adecuada.

Formato de solicitud de API (JSON)

{ "requestInfo": { "apiOperationName": "GetAirtelPrepaidIncomingCallList", "accountNumber": "your_account_number" } }

Definiciones de campos

Carga de respuesta típica (Ilustrativa)

{ "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" } // ... más registros ] }

Notas críticas de implementación

• Autenticación: Esta API requiere token OAuth 2.0 / JWT en el encabezado Authorization (Bearer token). Obténlo a través del Portal de socios de Airtel / API Gateway.
• Límites de velocidad: Se aplica estricta limitación (por ejemplo, 10 req/min/cuenta). Implementa retroceso exponencial.
• Retención de datos: Los CDR (Registros detallados de llamadas) típicamente están disponibles por 6–12 meses según regulaciones de TRAI.
• Privacidad/Cumplimiento: El acceso requiere consentimiento explícito del suscriptor o mandato legal (reglas de divulgación de CDR). Se aplica la Ley DPDP 2023.
• Entorno: Usa endpoints de sandbox/UAT para pruebas. Los endpoints de producción requieren incorporación de aplicación certificada.
• Alternativa: Para usuarios finales, la Aplicación Airtel Thanks > "Uso" > "Historial de llamadas" o USSD *121*7# proporciona estos datos sin integración de API.

Esta API está destinada a socios B2B autorizados y sistemas internos. Los clientes individuales deben usar la aplicación Airtel Thanks o USSD para el historial de llamadas personal.