Conteúdo da loja do seller

Num marketplace, cada seller (lojista) tem uma vitrine própria, o microsite, com identidade e conteúdo dele. Estas rotas, em /api/v1/vendor, são o CMS do seller: banners (o carrossel de destaque), páginas (Política de trocas, Sobre nós) e posts de blog. Cada seller só enxerga e altera o que ele criou.

Como funciona

Conceitos-chave

Dono do conteúdo

Todo item criado aqui nasce com o vendor_id do seller do token. Consultar, alterar ou apagar um id de outro seller responde 404 (banner, página, post), como se não existisse. O administrador da loja gerencia o conteúdo do marketplace por /api/v1/admin.

Slugs

O slug é a parte da URL. A plataforma o normaliza: minúsculas, espaços viram hífen e tudo que não for a-z, 0-9 ou hífen é removido (acentos incluídos: promoção vira promoo). Envie sempre um slug já em ASCII. Na criação, um slug repetido recebe um sufixo (-2, -3); na alteração, um slug repetido é recusado.

Ver o resultado

Itens do seller aparecem só no microsite do seller, não na home do marketplace. Banner só aparece quando está active e dentro da janela de starts_at e ends_at; página só quando active; post só quando A e com published_at já passado.

Endpoints

Erros comuns

1. Mandar slug com acento. O acento é descartado, não convertido.
2. Esperar scheduled publicar sozinho. No banner, scheduled é um rascunho; a data não o ativa. Use active com starts_at e ends_at.
3. Criar post sem status. O padrão é publicado (A): ele vai ao ar na hora.
4. Tratar a 404 como erro de permissão. O id de outro seller também responde 404.
5. Mandar image_url de rede interna. Endereços locais e privados são recusados.
6. Apagar sem querer. Banner e post são apagados de vez; só a página é apagada de forma lógica.

Próximos passos