API Docs v1 api.hubiss.com.br

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.

GET /brands
Listar Marcas

Listar todas as Marcas cadastradas.

StatusQuando aconteceCorpo
401 401 —
Resposta
json
{
    "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"
}
Exemplo
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())
O token é usado apenas nesta requisição e não é armazenado.
POST /brands
Cadastrar Marca
StatusQuando aconteceCorpo
401 401 —
422 422 —
CampoTipoDescrição
name * string
Corpo enviado (JSON) json
{
    "name": "Alta Villa Shoes"
}
Resposta
json
{
    "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."
        ]
    }
}
Exemplo
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())
O token é usado apenas nesta requisição e não é armazenado.
GET /brands/{brandId}
Recuperar Marca

Retorna a Marca com essa id

StatusQuando aconteceCorpo
401 401 —
404 404 —
Nome Local Tipo Descrição
brandId * path integer
Resposta
json
{
    "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"
}
Exemplo
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())
O token é usado apenas nesta requisição e não é armazenado.
PUT /brands/{brandId}
Atualizar Marca
StatusQuando aconteceCorpo
401 401 —
404 404 —
422 422 —
Nome Local Tipo Descrição
brandId * path integer
CampoTipoDescrição
name * string
Corpo enviado (JSON) json
{
    "name": "Alta Villa Shoes"
}
Resposta
json
{
    "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."
        ]
    }
}
Exemplo
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())
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
Próximo passo
Siga para Produtos.