Documentação da API REST
APIs REST de números de telefone
Descubra os países e números disponíveis, inspecione a oferta completa e gira os números que possui.
Escolha a API e a credencial em conjunto
As contas aprovadas de Programadores e Automação, Empresas e Prestadores de Comunicações podem integrar os serviços ativados. Um programador individual não precisa de se apresentar como uma empresa. O envio de SMS/MMS por aplicações exige a aprovação de envio e o registo aplicáveis. O serviço para Particulares e famílias não tem uma API de envio de mensagens acessível ao cliente.
| Família de API | URL base | Autenticação e resultado |
|---|---|---|
| Comunicações v3 | https://api.multitel.net/v3 | Credenciais Basic aprovadas; tokens provisionados elegíveis apenas para operações que os suportem. JSON status e response. |
| Registo de emergência | https://api.multi.tel/emergency | Credenciais Basic aprovadas ou acesso bearer provisionado especificamente. JSON code, message e data. |
| Integrações REST do portal | Host e operação indicados na referência de desenvolvimento da sua conta | Use a credencial, os âmbitos (scopes) e o esquema documentados dessa operação. Os pedidos de sessão do navegador são uma superfície separada. |
Defina MULTITEL_API_USERNAME e MULTITEL_API_PASSWORD através da configuração de segredos do seu servidor antes de usar os exemplos. Nunca os incorpore em JavaScript público de navegador, em URLs ou no controlo de versões. As credenciais dedicadas são geridas em Definições de integração da API.
Ler o catálogo de países disponíveis
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multitel.net/v3/getcountries"A resposta v3 contém status e uma matriz response. As entradas de país incluem isocode, name, countrycode, informação sobre capacidades e next_function. A disponibilidade depende da conta e do inventário; um país não é uma promessa de que todos os prefixos ou tipos de número estejam em stock.
{
"status": {
"code": 200,
"msg": "Results: 1"
},
"response": [
{
"countrycode": "1",
"name": "United States",
"description": "United States",
"isocode": "US",
"is_mobile": 0,
"sms_coverage": 1,
"latitude": "37.0902",
"longitude": "-95.7129",
"next_function": "v3/getareas/US"
}
]
}Da descoberta à ativação
- Escolha o país, a subdivisão quando exigida, a área e o tipo de número usando as operações de geografia correspondentes.
- Leia os preços de configuração, mensais e de utilização do número selecionado, os canais, a franquia incluída e os requisitos de registo.
- Envie os documentos de utilizador final exigidos e consulte o seu estado. Um número pode permanecer pendente até à aprovação.
- Faça a encomenda uma só vez, com a seleção exata de inventário e preço. Se a resposta for incerta, consulte o seu inventário antes de submeter outra encomenda.
- Configure o encaminhamento de voz e a entrega de mensagens de forma independente e depois teste a rota completa pretendida.
Tratar erros e novas tentativas
- Falha de autenticação ou de permissão
- Verifique se a credencial da API está ativada, o serviço permitido e a restrição de IP de origem. Um cookie de sessão do portal não é uma credencial de integração.
- Crédito insuficiente ou aprovação pendente
- Resolva o saldo da conta, a aprovação de envio ou o requisito de documentos antes de repetir a operação.
- Sem resultado
- Trate um inventário vazio ou a ausência do nome do chamador como um resultado normal. Não presuma que um número sintaticamente válido tenha todos os serviços.
- Tempo limite de rede ou falha do serviço
- Use novas tentativas limitadas com espera progressiva (backoff) para leituras. Numa compra, envio ou registo, verifique primeiro o estado da operação; repetir um pedido aceite pode duplicar uma ação faturável.
O suporte a idempotência depende de cada família de API. A API de emergência suporta chaves de repetição; isso não torna idempotentes pedidos v3 arbitrários. Guarde os carimbos de data/hora, os IDs devolvidos e as respostas com dados sensíveis removidos para o suporte.
Continue com a referência da sua conta
A referência com sessão iniciada filtra as operações de acordo com as suas permissões e os serviços ativados. Utilize o respetivo host, o tipo de credencial, os campos de pedido e o esquema de resposta exatos. As consolas podem executar operações reais, incluindo compras e mensagens.