Token de Acesso (2.0)

Ponto inicial do uso de nossas API's. Usada para obter o Token de Acesso através da autenticação do usuário.

POST https://sandbox-api.invoisys.com.br/api/token

Headers

Name	Type	Description
Content-type	string	application/x-www-form-urlencoded​
Accept	string	application/json​

Request Body

Name	Type	Description
grant_type	string	Informar o literal password
username	string	Endereço de e-mail do usuário
password	string	A senha do usuário

Response

200 - Sucesso

{
  "access_token": "pehddf4BLGV8UZ4ZbUIZ81BO6BG6Fzpmrd1RZMSTiZeESZulk48EU7FSq33G1JhgxjNd1PPbm51zl_oik2JZJIghn53F13h1izGZshFwJgY40MAW68Bx3AMLPkaf7THTi9QfIfO19WRiAZnJNIok-oIC3jpbdmoiFeMS_bDD2C2bBXaZjAVtufONBc6yuliSnzkGd-TSjZZxE3jH2WFWnhDMpTMNHMQgVI3oobWiZwal-4j7ZtAioAwerOlR1ZNBRi5GL4zmQO050bsXAwhYRQAgxlLZtzJxuTIjztYaZYU",
  "token_type": "bearer",
  "expires_in": 92843
}

400 - Erro

GRANT_TYPE Incorreto

{
  "error": "unsupported_grant_type"
}

USERNAME ou PASSWORD inválido

{
  "error": "credenciais_invalidas",
  "error_description": "Credenciais inválidas."
}

Recomendações

• Criar uma rotina de atualização do token 2x ao dia (a cada 12 horas).

• Em todas as chamadas de endpoints deve ser incluído um tratamento para renovar o Token caso seja recebido retorno de response code 401.

Swagger

Você pode acessar nossa API e realizar testes diretamente na nossa plataforma Swagger!

Referências à API 📌

• Passo-a-Passo da NF-e
• Passo-a-Passo da NFC-e

Exemplo de Uso 💡

PHP

//Informando os parâmetros
$grant_type =   'password';
$username   =   '[e-mail]';
$password   =   'senha do usuário';

//Informando a URL e os parâmetros a serem passados
$url = 'https://sandbox-api.invoisys.com.br/api/token';
$dados = array('grant_type' => $grant_type, 'username' => $username, 'password' => $password);

//Configurando dados para a requisição
$opcoes = array(
        'http' => array(
        'header'  => "Content-type: application/x-www-form-urlencoded\r\n",
        'method'  => 'POST',
        'content' => http_build_query($dados)
    )
);

//Pegando e arrumando o retorno da API
$contexto  = stream_context_create($opcoes);
$retorno = file_get_contents($url, false, $contexto);
$autorizacao= json_decode($retorno, true);

//Armazendo o Token de Acesso em uma variável
$token = $autorizacao["access_token"];