01
Primeiros passos
02
Introdução
03
SIM Swap
simSwap query
04
Referências
Queries
Tipos
Leia Introdução ao GraphQL, com exemplos reais da nossa API.
Crie um usuário no portal do desenvolvedor.
Cadastre sua primeira aplicação.
Utilize o dashboard para acessar suas configurações de acesso.
Para explorar rapidamente as APIs aqui na página de documentação, use o console de GraphQL, na seção de referências. Nele, você pode ver as consultas de exemplo, executá-las e alterá-las.
Jaydson GomesDesenvolvedor Evangelista
Para efetuar consultas de SIM Swap é necessário ter um usuário cadastrado na plataforma de APIs e estar registrado como Card Issuer ou Acquirer.
O recurso sim-swap é uma consulta que retorna um intervalo de dias em que foi feita a alteração mais recente de SIM card para um número de celular.
Na consulta é passado um número de celular (phone) formado pelo sinal de positivo (+) que é opcional,o código do país (55), o código da região formado por dois caracteres, o número 9 referente a um prefixo e mais oito números que identificam o telefone.
No header é preciso informar o client_id
do aplicativo e o access_token
obtido no login da plataforma de APIs da Elo
query {
simSwap(
phone: "+5599999999999"
) {
tag,
swapMin,
swapMax
}
}
A consulta retorna um período mínimo e um período máximo, que formam o intervalo de dias da alteração, também é retornada uma tag que representa este intervalo.
swapMin: período mínimo em dias
swapMax: período máximo em dias (pode assumir o valor INF caso o retorno seja menor que 1 dia ou maior que 90 dias).
tag A: menos de 1 dia
tag B: troca de 1 a 3 dias
tag C: troca de 3 a 5 dias
tag D: troca de 5 a 10 dias
tag E: troca de 10 a 15 dias
tag F: troca de 15 a 30 dias
tag G: troca de 30 a 45 dias
tag H: troca de 45 a 90 dias
tag X: Operadora/Número não monitorado
tag Z: acima de 90 dias
Argumentos:
phone: String
obrigatório
Número do celular do cliente sem hifen, ponto e parênteses
Dados de validação do sim swap do cliente.
A consulta retorna um período mínimo e um período máximo, que formam o intervalo de dias da alteração,também é retornada uma tag que representa este intervalo.
Campos:
tag
:
String
Código que classifica o SimSwap ou Changemno do Número de Diretório Internacional de Assinantes da Mobile Station
Intervalo SWAP mínimo do período de tempo para troca do SimSwap.
tag A: menos de 1 dia
tag B: troca de 1 a 3 dias
tag C: troca de 3 a 5 dias
tag D: troca de 5 a 10 dias
tag E: troca de 10 a 15 dias
tag F: troca de 15 a 30 dias
tag G: troca de 30 a 45 dias
tag H: troca de 45 a 90 dias
tag X: Operadora/Número não monitorado
tag Z: acima de 90 dias
swapMin
:
String
Intervalo SWAP minimo do período de tempo para troca do SimSwap.
swapMin:
período mínimo em dias.
swapMax
:
String
Intervalo SWAP máximo do período de tempo para troca do SimSwap.
swapMax:
período máxino em dias (pode assumir o valor INF caso o retorno seja menor que 1 dia ou maior que 90 dias)
.