>> Tecnologia Eletrônica >  >> Celulares e Acessórios >> Cartões SIM

API de Lista de Chamadas Recebidas Airtel Pré-pago: Formato de Requisição e Parâmetros

Para recuperar programaticamente um histórico detalhado de chamadas recebidas de uma conta Airtel pré-paga via API, use a seguinte estrutura de requisição JSON. Tipicamente usado por parceiros corporativos, sistemas de billing ou apps de autoatendimento com autorização adequada.

Formato de Requisição da API (JSON)

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

Definições dos Campos

CampoTipoObrigatórioDescrição
requestInfoObjetoSimWrapper para metadados da operação.
apiOperationNameStringSimValor fixo: "GetAirtelPrepaidIncomingCallList". Identifica a operação API específica.
accountNumberStringSimNúmero móvel Airtel pré-pago (MSISDN) ou ID da conta para o qual a lista de chamadas é solicitada. Formato: 91XXXXXXXXXX (Índia) ou formato local por círculo.

Payload de Resposta Típico (Ilustrativo)

{ "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" } // ... mais registros ] }

Notas Críticas de Implementação

  • Autenticação: Esta API requer token OAuth 2.0 / JWT no header Authorization (Bearer token). Obtenha via Portal de Parceiros Airtel / API Gateway.
  • Limites de Taxa: Throttling estrito aplica-se (ex.: 10 req/min/conta). Implemente backoff exponencial.
  • Retenção de Dados: CDR (Call Detail Records) tipicamente disponíveis por 6–12 meses per regulamentações TRAI.
  • Privacidade/Conformidade: Acesso requer consentimento explícito do assinante ou mandato legal (regras de divulgação CDR). Lei DPDP 2023 aplica-se.
  • Ambiente: Use endpoints sandbox/UAT para testes. Endpoints de produção requerem onboarding de app certificado.
  • Alternativa: Para usuários finais, o Airtel Thanks App > "Uso" > "Histórico de Chamadas" ou USSD *121*7# fornece estes dados sem integração API.

Esta API é destinada a parceiros B2B autorizados e sistemas internos. Clientes individuais devem usar o app Airtel Thanks ou USSD para histórico pessoal de chamadas.