Consulte o registo de um número adquirido e a respetiva configuração armazenada. Esta operação devolve um objeto em vez do array do endpoint inventory.
Pedido
Utilize credenciais da API no lado do servidor através de HTTPS. Os exemplos leem as credenciais a partir de variáveis de ambiente; não contêm credenciais funcionais. Verifique status.code no corpo JSON, bem como o estado HTTP. Estes processadores legados nem sempre definem um estado de erro HTTP quando ocorre um erro da aplicação.
curl --user "$MULTITEL_API_USER:$MULTITEL_API_PASSWORD" \
"https://api.multitel.net/v3/numberinfo/12025550100"O segmento obrigatório do caminho é o número de telefone internacional armazenado, não o seu UUID nem uma extensão PBX. Este processador não utiliza parâmetros de consulta nem corpo do pedido.
Resposta
Esta estrutura de resposta é ilustrativa; não representa dados de uma conta nem uma cotação de preços atual.
{
"status": {
"code": 200,
"msg": ""
},
"response": {
"number": "12025550100",
"uuid": "NUMBER_UUID",
"description": "Main reception",
"isocode": "US",
"config": {
"uri": "sip:reception@example.com",
"uri2": "",
"uri3": "",
"forward_destination": "",
"sms_uri": "",
"sms_forward_destination": ""
},
"features": {
"voice": "1",
"sms": "1",
"mms": "0"
},
"status": {
"capacity": {
"assigned_channels": "2",
"used_channels": "0",
"overflow": "0",
"overage_charge": "0.01"
},
"origination": {
"origination_trunk_id": "ORIGINATION_ID",
"origination_trunk_name": "ORIGINATION_NAME",
"origination_country_iso": "US",
"origination_continent_iso": "NA",
"origination_continent_name": "North America"
},
"service_active": "1",
"force_codec": "",
"force_dtmf": ""
},
"billing": {
"cnam": "0",
"overflow": "0",
"autorenew": "1",
"persistent": "0",
"date_created": "2026-01-01 00:00:00"
},
"price": {
"setup_price": "0.00",
"monthly_price": "1.00",
"per_minute": "0.01",
"free_minutes": "0",
"remaining_minutes": "0",
"perminute_charges": "0"
},
"needs_registration": "0",
"vrating": "",
"country_id": "COUNTRY_REFERENCE",
"area_id": "AREA_REFERENCE",
"provider_id": "OPAQUE_LEGACY_REFERENCE"
}
}| Campo | Significado |
|---|---|
number, uuid, description, isocode | O número de telefone armazenado, o identificador opaco do número, a descrição e o código do país. |
config | Campos armazenados de destinos de voz, reencaminhamento externo, destino de SMS e reencaminhamento de SMS. Este endpoint não os altera. |
features | Indicadores armazenados de capacidade de voz, SMS e MMS. Não há garantia de que os indicadores legados armazenados sejam valores booleanos JSON. |
status.capacity | Valores de canais atribuídos e utilizados, configuração de transbordo e tarifa por utilização excedente armazenada. Estes são metadados armazenados, não uma nova cotação de capacidade nem um teste de chamada em tempo real. |
status.origination | Metadados de originação armazenados. Trate os identificadores como opacos; não derive lógica da aplicação a partir de nomes internos. |
status.service_active, force_codec, force_dtmf | Campos armazenados de ativação e configuração de media. Um indicador, por si só, não comprova o sucesso da entrega de comunicações de entrada. |
billing | Valores armazenados de CNAM, transbordo, renovação, persistência e criação. A sua consulta não altera a renovação nem outras definições de faturação. |
price | Preços armazenados de ativação, mensais e por minuto, e franquias de minutos. O processador não fornece um campo de moeda nem uma nova cotação. Não deduza a moeda a partir dos valores de exemplo nem os utilize como cotação de compra atual. |
Em comparação com inventory, este endpoint também devolve needs_registration, vrating, country_id, area_id, provider_id e price.perminute_charges. Estes são valores legados armazenados, não uma resposta separada de aprovação de identidade. Os identificadores de referência devem ser tratados como opacos; não construa URLs de descoberta nem deduza mapeamentos de fornecedores a partir deles sem a resposta de descoberta adequada.
Nenhum número correspondente
Se não for encontrado nenhum registo correspondente não anulado para a conta autenticada, o corpo JSON apresenta status.code 404 e uma mensagem que contém number not found. Não se baseie no sufixo que indica a linha do código-fonte. Verifique o número armazenado e inventory antes de tentar novamente.
Utilizar o resultado
Esta operação consulta dados guardados. Não compra um número, não aprova documentos de identidade, não altera um destino nem garante a entrega de uma chamada, fax ou mensagem. Teste cada serviço ativado separadamente ao configurar um número.