Saltar para o conteúdo principal

Categorias e marcas

Categorias e marcas funcionam da mesma forma, cada uma com suas rotas.

RotaEscopoO que faz
GET /v1/categories · GET /v1/brandsreadlista
GET /v1/categories/{id} · GET /v1/brands/{id}readmostra uma
POST /v1/categories · POST /v1/brandswritecria
PATCH /v1/categories/{id} · PATCH /v1/brands/{id}writealtera
DELETE /v1/categories/{id} · DELETE /v1/brands/{id}deleteexclui

Campos​

CampoTipoDescrição
idUUIDidentificador
nametextonome
created_at, updated_atdata e horacriação e última alteração

Listar​

ParâmetroDescrição
qbusca no nome (contém o texto, sem diferenciar maiúsculas)
updated_sincesó as criadas ou alteradas a partir desse instante
limit, cursorpaginação

Criar e alterar​

CampoObrigatórioRegras
namesim1 a 100 caracteres
idnão (só no POST)UUID gerado por você
curl -X POST https://api.validades.com/v1/categories \
-H "Authorization: Bearer vld_live_SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{"name": "Laticínios"}'

Excluir​

Excluir uma categoria ou marca não exclui os produtos: eles ficam sem categoria ou sem marca (o campo vira null, e o produto aparece em updated_since).

{
"data": {
"id": "…",
"deleted": { "category": 1 },
"products_unlinked": 12
}
}

Em marcas, o campo é "deleted": { "brand": 1 }. Aceita If-Match.