Edição das 13h47min de 19 de setembro de 2025

Esta API pode verificar ou recuperar o número de telefone celular atualmente alocado pela operadora de rede ao SIM no dispositivo do usuário final

Number Verification

(Stable CAMARA APIs)

Descrição da API

A API “Verificação de Número” é um serviço que permite que empresas confirmem facilmente a propriedade de um número de telefone celular e recuperem o número diretamente do dispositivo do usuário.

Dois mecanismos são utilizados para obter as informações:

Baseado em rede: a operadora de rede sabe a qual assinante um telefone móvel conectado à rede pertence e qual é o seu número de telefone associado ou,
Baseado em SIM: Mecanismo de autenticação baseado na identificação do SIM do assinante instalado no dispositivo do usuário.

Esta API garante que o número de telefone fornecido ou obtido corresponda ao associado ao dispositivo do usuário, permitindo uma autenticação segura e confiável. Esta API elimina a necessidade de entradas manuais, como códigos SMS, simplificando processos como criação de conta, login ou validação de transações. Ela oferece uma solução prática para setores que exigem verificação e recuperação precisas de números de telefone, aprimorando a experiência do usuário, a prevenção de fraudes e a eficiência operacional.

Como a API de verificação de número ajuda a facilitar a autenticação?

A API de Verificação de Número utiliza mecanismos de telecomunicações para autenticar usuários perfeitamente com base na conexão de seus dispositivos à rede. Este método contrasta com as soluções de autenticação tradicionais, aumentando a conveniência e a segurança do usuário. Ao contrário de processos manuais ou códigos de texto simples, a validação baseada em rede não requer interação do usuário, reforçando a proteção contra acesso não autorizado.

Esta API verifica se o número de telefone celular fornecido (MSISDN) corresponde ao dispositivo que inicia a comunicação de dados, garantindo que os usuários interajam com serviços digitais de dispositivos autenticados.

Casos de uso

Funcionalidade da API

A API define um endpoint de serviço:

POST /verify

(1)
(2)
(3)
(4)

Entradas

Exemplo de Request body:

<syntaxhighlight lang="json"> {

 "ageThreshold": 18,
 "phoneNumber": "+34629255833",
 "idDocument": "66666666q",
 "name": "Federica Sanchez Arjona",
 "givenName": "Federica",
 "familyName": "Sanchez Arjona",
 "middleNames": "Sanchez",
 "familyNameAtBirth": "YYYY",
 "birthdate": "1978-08-22",
 "email": "federicaSanchez.Arjona@example.com",
 "includeContentLock": true,
 "includeParentalControl": true

} </syntaxhighlight>

Saídas

Se bem-sucedido, um objeto JSON será retornado contendo os seguintes dados:

ageCheck: Indique 'true' quando a idade do usuário for igual ou superior ao limite de idade (idade >= limite de idade) e 'false' caso contrário (idade < limite de idade). Caso contrário, 'not_available'.
verifiedStatus: verdadeiro se as informações fornecidas foram verificadas com outra forma de identificação oficial; caso contrário, falso.
identityMatchScore: A pontuação geral das informações de identidade disponíveis no Operador, informações fornecidas no corpo da solicitação, comparando-as com as que o MNO possui, ou utilizando diretamente informações internas do MNO. É opcional para o Operador retornar a pontuação de correspondência de identidade.
contentLock: Indica se a assinatura associada ao número de telefone tem algum tipo de bloqueio de conteúdo (ou seja, determinado conteúdo da web bloqueado).
parentalControl: Indica se a assinatura associada ao número de telefone tem algum tipo de controle parental ativado.

Exemplo de Response 200 OK: