API - Token de Acesso

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

post
API - Token

https://sandbox-api.invoisys.com.br/api/token
Ela disponibilizará um access_token, que será utilizado na comunicação com as API's.
Request
Response
Request
Headers
Content-type
required
string
application/x-www-form-urlencoded
Accept
required
string
application/json​
Form Data Parameters
grant_type
optional
string
Informar o literal password
username
optional
string
Endereço de e-mail do usuário
password
optional
string
A senha do usuário
Response
200: OK
Retorno com sucesso, com um access_token exemplo
{
"access_token": "pehddf4BLGV8UZ4ZbUIZ81BO6BG6Fzpmrd1RZMSTiZeESZulk48EU7FSq33G1JhgxjNd1PPbm51zl_oik2JZJIghn53F13h1izGZshFwJgY40MAW68Bx3AMLPkaf7THTi9QfIfO19WRiAZnJNIok-oIC3jpbdmoiFeMS_bDD2C2bBXaZjAVtufONBc6yuliSnzkGd-TSjZZxE3jH2WFWnhDMpTMNHMQgVI3oobWiZwal-4j7ZtAioAwerOlR1ZNBRi5GL4zmQO050bsXAwhYRQAgxlLZtzJxuTIjztYaZYU",
"token_type": "bearer",
"expires_in": 92843
}
400: Bad Request
Mensagens de erro
GRANT_TYPE Incorreto
USERNAME ou PASSWORD inválido
GRANT_TYPE Incorreto
{
"error": "unsupported_grant_type"
}
USERNAME ou PASSWORD inválido
{
"error": "credenciais_invalidas",
"error_description": "Credenciais inválidas."
}

Referências à API 📌

Exemplo de Uso 💡

PHP
PHP
//Informando os parâmetros
$grant_type = 'password';
$username = '[email protected]';
$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"];