Autenticação
A API de Produtos V1 utiliza uma autenticação diferente da API V2. Obs.: A API V1 (Produtos) está em processo de migração para a mesma arquitetura da V2.

Autenticação API V1

Cadastro de produtos e busca de etiquetas

API Explorer V1: https://hub2bapi.docs.apiary.io/ Domínio/URL Base: https://eb-api.plataformahub.com.br/RestServiceImpl.svc/{Recurso desejado} Token de acesso: solicitar token para [email protected]
Todas as URLs referenciadas neste documento utilizam autenticação. O método de autenticação utilizado é através de um cabeçalho (Header) HTTP. Isto significa que suas credenciais serão solicitadas em todas as requisições. Sessões não são utilizadas nas requisições. O cabeçalho de autenticação responsável por identificar o aplicativo Client é a chave "Auth", onde o valor é repassado pela equipe de Suporte da Plataforma Hub.
Exemplo de requisição com autenticação:
1
curl --location --request GET 'https://eb-api.plataformahub.com.br/RestServiceImpl.svc/shippinglabel/2032?order=shp-1234PG1234' \
2
--header 'Content-Type: application/json' \
3
--header 'Auth: ifskdjlfsdjhjkaçlsdkfjn'
Copied!

Definição de código de resposta

Para todas as requisições que forem efetuadas com sucesso o código HTTP retornado é 200. Se algo de errado acontecer durante o processamento da aplicação, a mensagem de erro será retornada na resposta da requisição. Se algo de errado acontecer na recepção da requisição, uma mensagem de erro HTTP/1.1 será retornada (faixa 400, 500). O retorno 429 por exemplo ocorre quando foram excedidos os limites de requisição que estão documentados no próximo link.

Paginação

A paginação, no retorno das chamadas, é baseado em páginas (offset) e limites (limit). Por padrão, o limite de registros é 50. As páginas incrementam de 1 em 1 a cada 50 registros.

Formatos de requisição e resposta

O formato de dados das requisições e respostas é application/json.

Autenticação API V2

Preço, estoque, categorias, novas contas, integrações e pedidos

Todas as rotas que iniciam com https://rest.hub2b.com.br utilizam esta forma de autenticação.
API Explorer:
Domínio/URL Base: https://rest.hub2b.com.br/{Recurso desejado}
Nessa versão da API, a autenticação é um pouquinho diferente, você pode obter um token de acesso realizando a request abaixo:
Headers: Content-Type: application/json Body:
1
{
2
"client_id": "clientid",
3
"client_secret": "clientsecret",
4
"grant_type": "password",
5
"scope": "inventory orders catalog",
6
"username": "username",
7
"password": "password"
8
}
Copied!
Essa requisição retorna um access_token, que deve ser utilizado em todas as requisições da API V2, passando via parâmetro na URL.
1
{
2
"refresh_token": "string",
3
"token_type": "bearer",
4
"access_token": "string",
5
"expires_in": 7200
6
}
Copied!
A API tem uma limitação de 30 Logins diários, sendo que para gerar um novo token é mais eficiente utilizar o refresh_token para ganhar mais 2 horas de acesso no novo access_token. Para isto basta renovar o token em ​/oauth2​/token que é uma rota disponível em todos nossos recursos. E sempre enviando os seguintes dados:
1
{
2
"client_id": "string",
3
"grant_type": "refresh_token",
4
"client_secret": "string",
5
"refresh_token": "string"
6
}
Copied!
Last modified 3mo ago