Cadastre-se ou entre com o seu E-mail

Autenticação

Esta API usa somente o nível de autenticação de aplicação. Siga os passos abaixo para autenticar com sucesso:

1

Registre seu aplicativo para obter seu App-Token (client_id) no menu APPs

 

2

Informe seu App-Token (client_id) no header de cada requisição.

 

3

Não se preocupe, todas as informações de cada parâmetro (seja Header ou query) a serem supridos estão detalhados no menu Documentação > API Browser.

 

4

O Token tem Validade de 4 horas, a cada 4 horas uma nova requisição deve ser feita a API OAuth para gerar um novo Token.

 

OAuth 2.0

Para realizar o fluxo oAuth, basta realizar um POST no endpoint de oauth (vide abaixo) utilizando os headers "Content-type:application/json" e "Authorization:Basic SEU_CLIENT_ID_:_SECRET_EM_BASE64"

Para converter seu client_id e o seu secret em Base64 usando o terminal (Unix, Linux e Mac), basta utilizar o comando: echo -n "CLIENT_ID:SECRET" |base64

Caso desejar, pode realizar essa conversão online, no site "https://www.base64encode.org (Deixar a opção UTF-8 e LF(Unix) por default selecionadas).

O body deve ser composto de 4 informações:

  • {
  • "grant_type": "password",
  • "username" : "seu email",
  • "password" : "sua senha",
  • "cpfCnpj" : "seu CNPJ ou CPF"
  • }

Endpoints

Access-token HML http://api-hml.gs1br.org/oauth/access-token
Access-token PRD http://api.gs1br.org/oauth/access-token
Português, Brasil