Pular para o conteúdo principal

Remote

Como fazer chamadas HTTP​

Introdução​

Muitas vezes, em nossas aplicações, precisamos fazer requisições HTTP para serviços externos. Isso pode ser feito utilizando o _remote.

Chamadas HTTP​

Iniciando a requisição​

Para que possamos realizar uma chamada HTTP, devemos primeiramente inicia-la, para isso utilizaremos o método init do _remote e então guardaremos o resultado desta operação em uma variável chamada remote para que assim tenhamos como referenciar a requisição:

const remote = _remote.init();

Request method indicated​

Não precisamos indicar explicitamente no cabeçalho da chamada o seu método HTTP, para isso a nossa referência da chamada possui uma função para cada método HTTP:

const remote = _remote.init();

remote.post(); // para chamadas POST
remote.get(); // para chamadas GET
remote.put(); // para chamadas PUT
remote.delete(); // para chamadas DELETE

Editando cabeçalhos HTTP​

const remote = _remote.init();
remote.getHeader().set("CHAVE", "VALOR");

Indicando a URL da requisição​

Para indicar a URL da requisição basta que passemos ela como o primeiro parâmetro da função:

const remote = _remote.init();

remote.post("http://exemplo.com"); // para chamadas POST
remote.get("http://exemplo.com"); // para chamadas GET
remote.put("http://exemplo.com"); // para chamadas PUT
remote.delete("http://exemplo.com"); // para chamadas DELETE

Adicionando dados à requisição​

Caso precise adicionar dados ao corpo da chamada, basta passar os mesmos como segundo parâmetro da função:

const remote = _remote.init();

remote.post("http://exemplo.com", {"user_id": 1}); // para chamadas POST
remote.get("http://exemplo.com", {"user_id": 1}); // para chamadas GET
remote.put("http://exemplo.com", {"user_id": 1}); // para chamadas PUT
remote.delete("http://exemplo.com", {"user_id": 1}); // para chamadas DELETE

Lendo a resposta da requisição​

Depois de receber a resposta da requisição podemos ler seus dados utilizando o método content:

const remote = _remote.init();

const response = remote.post("http://exemplo.com", {"user_id": 1}); // para chamadas POST
const response = remote.get("http://exemplo.com", {"user_id": 1}); // para chamadas GET
const response = remote.put("http://exemplo.com", {"user_id": 1}); // para chamadas PUT
const response = remote.delete("http://exemplo.com", {"user_id": 1}); // para chamadas DELETE

if (response.ok()) {
    _log.info("response", response.content());
} else {
    _log.info("failed "+ response.statusCode(), response.content());
}