Verificar o inventário móvel para uma central

Escolha um prefixo suportado

Use um prefixo móvel individual atual da descoberta. Este endpoint destina-se a centrais NANPA: um NPA identifica o código de área e um NXX identifica a central. Um prefixo apenas com o código de área é demasiado abrangente. Não envie IDs de exibição agrupados nem infira suporte para outro país porque o respetivo prefixo contém dígitos suficientes.

Use a contagem como uma indicação

Leia response.count, com response.npa e response.nxx a identificar a central. Esta é uma imagem momentânea do serviço de cobertura, não stock mantido para a sua conta. Confirme os números reais, as cotações aplicáveis e quaisquer requisitos de registo antes de encomendar. Uma contagem bem-sucedida nunca autoriza uma compra.

Distinga stock zero de uma consulta falhada

Uma contagem bem-sucedida de zero difere de um erro da API. Inspecione status.code e status.msg , bem como o estado HTTP. Trate um tempo limite ou uma consulta falhada como disponibilidade desconhecida e tente novamente mais tarde com backoff.

Pedido

Utilize as credenciais da sua conta de API ativada por HTTPS. A autenticação Basic e os bearer tokens de contas de API ativadas são suportados; aplicam-se restrições de conta.

GET com o identificador do prefixo no caminho do URL. Não existem parâmetros de consulta ou de corpo documentados.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/getmobilecount/$PREFIX_ID"

Resposta

Verifique status.code no corpo JSON, bem como o estado HTTP. Uma response bem-sucedida tem status.code 200 e status.msg Results. response é um objeto, não uma lista: count é um número inteiro com a imagem momentânea do inventário; npa e nxx são cadeias de três caracteres. status.results não está presente para este objeto associativo. Uma contagem de 0 significa que a consulta de cobertura não encontrou uma central correspondente ou devolveu stock zero; não prova que todos os fornecedores ou outras rotas de descoberta estejam sem números.

Forma de resposta ilustrativa; não são dados reais da conta nem uma cotação atual.

{
  "status": {
    "code": 200,
    "msg": "Results"
  },
  "response": {
    "count": 42,
    "npa": "212",
    "nxx": "555"
  }
}

Erros

• 404: Fornecedor desativado: a cobertura de inventário móvel está indisponível no serviço.
• 404: ID de prefixo inválido: obtenha um ID de prefixo individual atual da descoberta.
• 404: Prefixo inválido: o prefixo armazenado não contém dígitos suficientes para uma consulta NPA/NXX.
• 500: Falha na cobertura de inventário: a consulta a montante não devolveu um resultado de cobertura bem-sucedido. Tente novamente mais tarde com backoff; uma falha não é uma contagem de stock zero.

Disponibilidade e efeitos secundários

• A operação verifica o inventário e não faz um pedido, não reserva números nem debita um valor de compra.
• O stock pode mudar imediatamente. A contagem de cobertura não é ajustada para prometer a possibilidade de compra específica da conta ou o mesmo comprimento da próxima resposta de pesquisa de números.
• Uma consulta contacta o serviço de cobertura e pode demorar. Não faça sondagens repetidas a todos os prefixos nem trate um tempo limite/erro como stock zero bem-sucedido.