Sobre a API da MultiTEL:
Esta API é fornecida para programadores que pretendam integrar-se com a nossa plataforma de voz ou desenvolver sobre ela.
As nossas APIs dão acesso a recursos (entidades de dados) através de caminhos URI. Para utilizar uma API REST, a sua aplicação
fará um pedido HTTP e analisará a resposta. Por predefinição, o formato da resposta é JSON.
Seus métodos serão os métodos HTTP padrão GET e POST. Como a API baseia-se em padrões abertos,
você pode usar qualquer linguagem de desenvolvimento Web para acessar a API.
Endpoint utilizado:
https://api.multitel.net/v3
Autenticação:
A MultiTEL APIv3 utiliza autenticação HTTP Basic/Digest. Isto permite-lhe proteger os URLs no seu servidor web, de modo a que apenas o utilizador e a MultiTEL
possam aceder-lhes. Para se autenticar por HTTP, pode indicar um nome de utilizador e uma palavra-passe com o seguinte formato de URL:
https://USERNAME:PASSWORD@api.multitel.net/v3/getcountries
Para a autenticação HTTP Basic, utilizará o nome de utilizador e a palavra-passe da sua conta MultiTEL.
Como alternativa, pode definir utilizadores de API dedicados aqui: https://multitel.net/settings.
curl -G https://api.multitel.net/v3/getcountries \
-u '[YOUR USERNAME]:[YOUR PASSWORD]'
Saída:
Todas as funções da API devolverão as secções status e response. O estado será um código numérico baseado nos códigos de estado HTTP.
Tudo o que tenha o código de estado 200 será considerado sucesso.
Tudo o que tenha um código de estado na gama 4xx será considerado um erro do cliente (códigos de proibido, códigos de saldo insuficiente, etc).
Tudo o que tenha um código de estado na gama 5xx será considerado um erro do servidor.
Exemplo de resposta, abaixo:
{
"status": {
"code": 200,
"msg": ""
},
"response": {
"number": "33554530000",
"price": {
"per_minute": "0.006",
"free_minutes": "0",
"setup_price": "0",
"monthly_price": "0.7",
"channels": "0",
"overflow": "1"
}
}
}Resposta ilustrativa da referência RentNumber; os valores de exemplo não são uma cotação atual.