Requisições HTTP (AXIOS)

Chamadas fáceis de API - Request (Assíncrona)

info

Imprescindível o uso do modificador await antes da função

A conexão com APIs externas é muito fácil usando um comando simplificado. Toda complexidade é encapsulada, permitindo chamar APIs de forma muito fluida

O serviço é internamente baseado no plugin AXIOS, que efetua uma chamada para um endpoint, recebe como argumentos o método da chamada, uma URL, um objeto para ser enviado no body (opcional) e argumentos extras (headers, cookies, etc)

Se a resposta for 200, retorna o objeto BODY da resposta. Caso ocorra algum erro, retornará false

Em ambientes DEV, a mensagem de erro é enviada como mensagem automaticamente junto do statusCode

/* 
Primeiro Parâmetro: Método (string)
Segundo Parâmetro: URL (string)
*/
const resp = await request("get", "https://xxxxx.com");
if (resp) {
    //Sucesso - resp é o objeto retornado do entpoint
} else {
    //Erro.
}

/* 
Primeiro Parâmetro: Método (string)
Segundo Parâmetro: URL (string)
Terceiro Parâmetro: Body (JSON) - Opcional
*/
const resp = await request("post", "https://xxxxx.com", {
    value: "x"
});
if (resp) {
    //Sucesso - resp é o objeto retornado do entpoint
} else {
    //Erro.
}

/* 
Primeiro Parâmetro: Método (string)
Segundo Parâmetro: URL (string)
Terceiro Parâmetro: Body (JSON) - Opcional
Quarto Parâmetro: Extras (JSON) - Opcional
*/
const body = {
    value: "X"
};
const opts = {
    headers: {
        Authorization: "XXXX"
    }
};
const resp = await request("post", "https://xxxxx.com", body, opts);
if (resp) {
    //Sucesso - resp é o objeto retornado do entpoint
} else {
    //Erro.
}

/* 
Primeiro Parâmetro: Método (string)
Segundo Parâmetro: URL (string)
Terceiro Parâmetro: Body (JSON) - Opcional
Quarto Parâmetro: Extras (JSON) - Opcional
Quinto Parâmetro: Não enviar erros como mensagem em ambiente DEV (bool) - Opcional
*/
const resp = await request("get", "https://xxxxx.com", null, null, true);
if (resp) {
    //Sucesso - resp é o objeto retornado do entpoint
} else {
    //Erro.
    //Em ambiente de DEV a mensagem de erro não é mostrada
}