Categorias e marcas
Categorias e marcas funcionam da mesma forma, cada uma com suas rotas.
| Rota | Escopo | O que faz |
|---|---|---|
GET /v1/categories · GET /v1/brands | read | lista |
GET /v1/categories/{id} · GET /v1/brands/{id} | read | mostra uma |
POST /v1/categories · POST /v1/brands | write | cria |
PATCH /v1/categories/{id} · PATCH /v1/brands/{id} | write | altera |
DELETE /v1/categories/{id} · DELETE /v1/brands/{id} | delete | exclui |
Campos
| Campo | Tipo | Descrição |
|---|---|---|
id | UUID | identificador |
name | texto | nome |
created_at, updated_at | data e hora | criação e última alteração |
Listar
| Parâmetro | Descrição |
|---|---|
q | busca no nome (contém o texto, sem diferenciar maiúsculas) |
updated_since | só as criadas ou alteradas a partir desse instante |
limit, cursor | paginação |
Criar e alterar
| Campo | Obrigatório | Regras |
|---|---|---|
name | sim | 1 a 100 caracteres |
id | nã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.