Marcas
A marca é obrigatória no produto e influencia o ranqueamento nos marketplaces.
Em resumo
A marca é obrigatória no produto e vem do nome informado no cadastro — este endpoint serve para consultar e padronizar.
Uma marca na Hubiss atribui o produto a um fabricante. Todo produto tem uma marca, e ela é importante para ranquear o anúncio nos marketplaces.
Por que cadastrar uma marca?
Você não precisa cadastrar a marca antes de criar o produto: basta informar o nome da marca no cadastro do produto e a Hubiss vincula automaticamente. O endpoint de marcas serve para consultar a lista e cadastrar marcas separadamente.
Por que algumas marcas já estão cadastradas?
As marcas são únicas no mercado e não mudam de nome. Para manter o padrão, todas as marcas cadastradas na Hubiss aparecem para todos os usuários — se a marca já existir, você não precisa cadastrar de novo.
Listar Marcas
Listar todas as Marcas cadastradas.
Erros possíveis
Status Quando acontece Corpo
401
401
—
Respostas
Resposta
200
401
json
Copiar
{
"data": [
{
"id": 114,
"name": "Alta Villa Shoes",
"created_at": "2021-04-06 21:47:51",
"updated_at": "2021-04-06 21:47:51"
},
{
"id": 110,
"name": "Arrasadora",
"created_at": "2020-02-26 23:41:07",
"updated_at": "2020-02-26 23:41:07"
},
{
"id": 5,
"name": "Brinquedos Bandeirante",
"created_at": "2018-10-18 23:48:41",
"updated_at": "2018-10-18 23:48:41"
},
{
"id": 2,
"name": "Fisher Price",
"created_at": "2018-10-18 23:47:32",
"updated_at": "2018-10-18 23:47:32"
},
{
"id": 113,
"name": "Lumi Cosméticos",
"created_at": "2021-03-28 10:52:10",
"updated_at": "2021-03-28 10:52:10"
},
{
"id": 112,
"name": "Modacc",
"created_at": "2020-03-05 23:25:02",
"updated_at": "2021-01-27 17:34:14"
},
{
"id": 111,
"name": "Sem Marca",
"created_at": "2020-02-26 23:41:24",
"updated_at": "2020-02-26 23:41:24"
},
{
"id": 109,
"name": "Torricella",
"created_at": "2020-02-03 23:41:09",
"updated_at": "2020-02-03 23:41:09"
}
],
"links": {
"first": "https://hubiss.dev/api/v1/brands?page=1",
"last": "https://hubiss.dev/api/v1/brands?page=1",
"prev": null,
"next": null
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 1,
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "https://hubiss.dev/api/v1/brands?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"path": "https://hubiss.dev/api/v1/brands",
"per_page": 100,
"to": 8,
"total": 8
}
}
{
"error": "Unauthorized"
}
Exemplos por linguagem
Exemplo
curl
PHP
JavaScript
Python
Copiar
curl --request GET \
--url 'https://api.hubiss.com.br/v1/brands' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer SEU_TOKEN'
use Illuminate\Support\Facades\Http;
$response = Http::withToken('SEU_TOKEN')
->acceptJson()
->get('https://api.hubiss.com.br/v1/brands');
$response->json();
const response = await fetch('https://api.hubiss.com.br/v1/brands', {
method: 'GET',
headers: {
'Accept': 'application/json',
'Authorization': 'Bearer SEU_TOKEN'
}
});
const data = await response.json();
import requests
response = requests.GET(
'https://api.hubiss.com.br/v1/brands',
headers={'Authorization': 'Bearer SEU_TOKEN', 'Accept': 'application/json'},
)
print(response.json())
Cadastrar Marca
Erros possíveis
Status Quando acontece Corpo
401
401
—
422
422
—
Corpo da requisição
Campo Tipo Descrição
name
*
string
Corpo enviado (JSON)
json
Copiar
{
"name": "Alta Villa Shoes"
}
Respostas
Resposta
201
401
422
json
Copiar
{
"data": {
"id": 115,
"name": "Alta Villa Shoes",
"created_at": "2022-03-29 22:27:06",
"updated_at": "2022-03-29 22:27:06"
},
"success": true,
"message": "Register Successfull Inserted"
}
{
"error": "Unauthorized"
}
{
"success": false,
"message": "Validation errors",
"data": {
"name": [
"The name field is required."
]
}
}
Exemplos por linguagem
Exemplo
curl
PHP
JavaScript
Python
Copiar
curl --request POST \
--url 'https://api.hubiss.com.br/v1/brands' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer SEU_TOKEN' \
--header 'Content-Type: application/json' \
--data '{ "name": "Alta Villa Shoes"}'
use Illuminate\Support\Facades\Http;
$response = Http::withToken('SEU_TOKEN')
->acceptJson()
->withBody("{\n \"name\": \"Alta Villa Shoes\"\n}", 'application/json')
->post('https://api.hubiss.com.br/v1/brands');
$response->json();
const response = await fetch('https://api.hubiss.com.br/v1/brands', {
method: 'POST',
headers: {
'Accept': 'application/json',
'Authorization': 'Bearer SEU_TOKEN',
'Content-Type': 'application/json'
},
body: JSON.stringify({
"name": "Alta Villa Shoes"
})
});
const data = await response.json();
import requests
response = requests.POST(
'https://api.hubiss.com.br/v1/brands',
headers={'Authorization': 'Bearer SEU_TOKEN', 'Accept': 'application/json'},
json={
"name": "Alta Villa Shoes"
},
)
print(response.json())
GET
/brands/{brandId}
link
Recuperar Marca
Retorna a Marca com essa id
Erros possíveis
Status Quando acontece Corpo
401
401
—
404
404
—
Parâmetros
Nome
Local
Tipo
Descrição
brandId
*
path
integer
Respostas
Resposta
200
401
404
json
Copiar
{
"data": {
"id": 114,
"name": "Alta Villa Shoes",
"created_at": "2021-04-06 21:47:51",
"updated_at": "2021-04-06 21:47:51"
}
}
{
"error": "Unauthorized"
}
{
"error": "Resource 9999 not found"
}
Exemplos por linguagem
Exemplo
curl
PHP
JavaScript
Python
Copiar
curl --request GET \
--url 'https://api.hubiss.com.br/v1/brands/BRANDID' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer SEU_TOKEN'
use Illuminate\Support\Facades\Http;
$response = Http::withToken('SEU_TOKEN')
->acceptJson()
->get('https://api.hubiss.com.br/v1/brands/BRANDID');
$response->json();
const response = await fetch('https://api.hubiss.com.br/v1/brands/BRANDID', {
method: 'GET',
headers: {
'Accept': 'application/json',
'Authorization': 'Bearer SEU_TOKEN'
}
});
const data = await response.json();
import requests
response = requests.GET(
'https://api.hubiss.com.br/v1/brands/BRANDID',
headers={'Authorization': 'Bearer SEU_TOKEN', 'Accept': 'application/json'},
)
print(response.json())
Testar este endpoint
Enviar requisição
O token é usado apenas nesta requisição e não é armazenado.
PUT
/brands/{brandId}
link
Atualizar Marca
Erros possíveis
Status Quando acontece Corpo
401
401
—
404
404
—
422
422
—
Parâmetros
Nome
Local
Tipo
Descrição
brandId
*
path
integer
Corpo da requisição
Campo Tipo Descrição
name
*
string
Corpo enviado (JSON)
json
Copiar
{
"name": "Alta Villa Shoes"
}
Respostas
Resposta
200
401
404
422
json
Copiar
{
"data": {
"id": 115,
"name": "Alta Villa Shoes",
"created_at": "2022-03-29 22:27:06",
"updated_at": "2022-03-29 22:27:06"
},
"success": true,
"message": "Register Successfull Inserted"
}
{
"error": "Unauthorized"
}
{
"error": "Resource 99999 not found"
}
{
"success": false,
"message": "Validation errors",
"data": {
"name": [
"The name field is required."
]
}
}
Exemplos por linguagem
Exemplo
curl
PHP
JavaScript
Python
Copiar
curl --request PUT \
--url 'https://api.hubiss.com.br/v1/brands/BRANDID' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer SEU_TOKEN' \
--header 'Content-Type: application/json' \
--data '{ "name": "Alta Villa Shoes"}'
use Illuminate\Support\Facades\Http;
$response = Http::withToken('SEU_TOKEN')
->acceptJson()
->withBody("{\n \"name\": \"Alta Villa Shoes\"\n}", 'application/json')
->put('https://api.hubiss.com.br/v1/brands/BRANDID');
$response->json();
const response = await fetch('https://api.hubiss.com.br/v1/brands/BRANDID', {
method: 'PUT',
headers: {
'Accept': 'application/json',
'Authorization': 'Bearer SEU_TOKEN',
'Content-Type': 'application/json'
},
body: JSON.stringify({
"name": "Alta Villa Shoes"
})
});
const data = await response.json();
import requests
response = requests.PUT(
'https://api.hubiss.com.br/v1/brands/BRANDID',
headers={'Authorization': 'Bearer SEU_TOKEN', 'Accept': 'application/json'},
json={
"name": "Alta Villa Shoes"
},
)
print(response.json())
Testar este endpoint
Corpo JSON
{
"name": "Alta Villa Shoes"
}
Enviar requisição
O token é usado apenas nesta requisição e não é armazenado.
Erros comuns
Sintoma
Causa provável
O que fazer
422 em name
Nome vazio
Informar o nome comercial da marca
Marca "não aparece"
Já existia na base global
Consultar a lista antes de criar