Documentação da API da SW Web

Como fazer a integração

Primeiramente, por motivos de segurança, é necessário ter um token para acessar os recursos da nossa API. Este token é gerado pela SW Web e é passado para você. Caso ainda não tenha um token, entre em contato com a nossa equipe de desenvolvedores.

Lembre-se de manter este token em um local seguro. Em hipótese alguma forneça-o para terceiros. Se suspeitar de qualquer falha de segurança e vazamento deste token, avise-nos imediatamente.

Tendo o token em mãos, é importante entender como é feita a comunicação com o nosso serviço. Para acessar algum recurso da API, é necessário realizar requisições a partir do seu servidor para o nosso servidor. Ou seja, a comunicação deve ser server-side com server-side. Se for necessário, poderá ser feita uma requisição assíncrona, via Ajax, por exemplo, do seu cliente para o seu servidor, mas nunca diretamente do seu cliente para o nosso servidor, devido à segurança do token.

A seguir é possível ver um exemplo dessa comunicação. Todos os exemplos de integração desta API serão apresentados utilizando a linguagem JavaScript, para o client-side, e a linguagem PHP, para o server-side. Entretanto, também é possível utilizar outras linguagens, desde que o código seja adaptado:

                
                    
let params = {
    method: 'POST',
    dataType: 'JSON',
    data: {
        codigo: 33
    },
    success: function(result) {
        // Na variável result está o resultado do cálculo em um objeto
        console.log(result);
    }
};

// Na URL da requisição, substitua os parâmetros:
// "seu_dominio" pelo seu domínio.
// "caminho" pelo caminho onde estará o método que processará a requisição no seu servidor
$.ajax('https://seu_dominio/caminho', params);
                
            

                
                    
function consultarCalculo() {
    $codigo = filter_input(INPUT_POST, 'codigo');
    // Neste caso, a URL será https://www.swweb.info/api/sw_fretes/v1/calculo_frete/33
    $curl = curl_init('http://www.swweb.info/api/sw_fretes/v1/calculo_frete/'. $codigo);
    
    // Substitua $seu_token$ pelo token de segurança que você recebeu.
    // Lembre-se de manter seu token em um lugar seguro.
    // Nunca o coloque em um arquivo JavaScript.
    curl_setopt($curl, CURLOPT_HTTPHEADER, [
        'Authorization: Token $seu_token$'
    ]);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($curl, CURLOPT_CONNECTTIMEOUT, 5);
    
    $result = curl_exec($curl);
    curl_close($curl);
    echo $result;
}                
            

Como utilizar os recursos

Sabendo como é feita a integração, é necessário entender como são feitas as requisições para os recursos da API. Portanto, selecione o software que você deseja consultar a documentação da API: