API atual/Referência completa/Categorias do seller

Categorias liberadas

Lista as categorias em que o administrador liberou o seller para vender e confere uma categoria específica.

Algumas lojas restringem onde cada seller pode vender: o administrador libera categorias para ele. Esta consulta é só de leitura; quem libera ou retira categorias é o administrador. Seller sem nenhuma liberação não tem restrição.

Listar liberadas

GET/api/v1/vendor/categoriesSeller

Listar as categorias liberadas

Cabeçalhos

Authorizationstringobrigatório

Bearer $TOKEN. Token de acesso do usuário seller (veja Tokens).

Exemplo de requisição (liberadas)

bash

curl "$BASE_URL/api/v1/vendor/categories" \
  -H "Authorization: Bearer $TOKEN"

Resposta (liberadas)

200Categorias liberadas

json

[
  {
    "id": "2d3e4f50-0001-4a1b-8c2d-3e4f5a6b7c8d",
    "vendor_id": "94bd7e9a-fdad-4d01-8fc2-ba9d677d8b36",
    "category_id": "345ac33e-4dcd-4d60-bedf-a2c2d47897d9",
    "created_at": "2026-10-01T12:00:00Z",
    "category_name": "Calçados",
    "category_slug": "calcados"
  }
]

Campos da resposta

(array)array

A resposta é uma lista JSON direta, sem objeto em volta. Cada item:

idstring (uuid)

Id da liberação.

vendor_idstring (uuid)

Seu seller.

category_idstring (uuid)

Categoria liberada.

category_namestring

Nome da categoria.

category_slugstring

Slug da categoria.

created_atstring

Quando foi liberada (RFC 3339).

Erros (liberadas)

Status	Quando	Corpo
401	Token ausente, inválido ou expirado.	`{"error":"missing authorization header"}`
403	Token que não é de seller.	`{"error":"insufficient permissions"}`
404	O recurso "categorias por seller" está desligado na loja.	`{"error":"categories_by_vendor feature is not enabled"}`

Conferir uma categoria

GET/api/v1/vendor/categories/{categoryId}/checkSeller

Conferir se pode vender na categoria

Cabeçalhos

Authorizationstringobrigatório

Bearer $TOKEN. Token de acesso do usuário seller (veja Tokens).

Parâmetros de caminho

categoryIdstring (uuid)obrigatório

Id da categoria.

Exemplo de requisição (conferir)

bash

curl "$BASE_URL/api/v1/vendor/categories/$CATEGORY_ID/check" \
  -H "Authorization: Bearer $TOKEN"

Resposta (conferir)

200Resultado

json

{
  "allowed": true
}

Campos da resposta

allowedboolean

true se o seller pode vender na categoria. Sem nenhuma categoria liberada, é true para qualquer categoria.

Erros (conferir)

Status	Quando	Corpo
401	Token ausente, inválido ou expirado.	`{"error":"missing authorization header"}`
403	Token que não é de seller.	`{"error":"insufficient permissions"}`
404	Recurso desligado, ou usuário sem cadastro de seller.	`{"error":"categories_by_vendor feature is not enabled"}`

Veja também

Categorias do seller: visão geral

Categorias liberadas

Lista as categorias em que o administrador liberou o seller para vender e confere uma categoria específica.

Listar liberadas

GET/api/v1/vendor/categoriesSeller

Listar as categorias liberadas

Cabeçalhos

Authorizationstringobrigatório

Bearer $TOKEN. Token de acesso do usuário seller (veja Tokens).

Exemplo de requisição (liberadas)

bash

curl "$BASE_URL/api/v1/vendor/categories" \
  -H "Authorization: Bearer $TOKEN"

Resposta (liberadas)

200Categorias liberadas

json

[
  {
    "id": "2d3e4f50-0001-4a1b-8c2d-3e4f5a6b7c8d",
    "vendor_id": "94bd7e9a-fdad-4d01-8fc2-ba9d677d8b36",
    "category_id": "345ac33e-4dcd-4d60-bedf-a2c2d47897d9",
    "created_at": "2026-10-01T12:00:00Z",
    "category_name": "Calçados",
    "category_slug": "calcados"
  }
]

Campos da resposta

(array)array

A resposta é uma lista JSON direta, sem objeto em volta. Cada item:

idstring (uuid)

Id da liberação.

vendor_idstring (uuid)

Seu seller.

category_idstring (uuid)

Categoria liberada.

category_namestring

Nome da categoria.

category_slugstring

Slug da categoria.

created_atstring

Quando foi liberada (RFC 3339).

Erros (liberadas)

Status	Quando	Corpo
401	Token ausente, inválido ou expirado.	`{"error":"missing authorization header"}`
403	Token que não é de seller.	`{"error":"insufficient permissions"}`
404	O recurso "categorias por seller" está desligado na loja.	`{"error":"categories_by_vendor feature is not enabled"}`

Conferir uma categoria

GET/api/v1/vendor/categories/{categoryId}/checkSeller

Conferir se pode vender na categoria

Cabeçalhos

Authorizationstringobrigatório

Bearer $TOKEN. Token de acesso do usuário seller (veja Tokens).

Parâmetros de caminho

categoryIdstring (uuid)obrigatório

Id da categoria.

Exemplo de requisição (conferir)

bash

curl "$BASE_URL/api/v1/vendor/categories/$CATEGORY_ID/check" \
  -H "Authorization: Bearer $TOKEN"

Resposta (conferir)

200Resultado

json

{
  "allowed": true
}

Campos da resposta

allowedboolean

true se o seller pode vender na categoria. Sem nenhuma categoria liberada, é true para qualquer categoria.

Erros (conferir)

Status	Quando	Corpo
401	Token ausente, inválido ou expirado.	`{"error":"missing authorization header"}`
403	Token que não é de seller.	`{"error":"insufficient permissions"}`
404	Recurso desligado, ou usuário sem cadastro de seller.	`{"error":"categories_by_vendor feature is not enabled"}`

Veja também

Categorias do seller: visão geral