VenddorDocumentação API
API atualAPI legada
Guia rápidoReferência completa
Carregando índice…
API atual/Referência completa/Sellers e microsites

Termos de adesão

Devolve a versão em vigor dos termos que o seller aceita ao se cadastrar.

O administrador da loja publica versões dos termos de adesão (regras para vender na loja). Só a versão mais recente fica ativa; ao publicar uma nova, a anterior deixa de valer. O aceite do seller é registrado por outra rota, do painel dele.

GET/api/v1/storefront/vendor-terms/activePública

Termos de adesão do seller em vigor

Devolve a versão em vigor dos termos que um seller aceita ao se cadastrar na loja. Serve para exibir o texto na página de cadastro de seller. Não exige token.

Exemplo de requisição

bash
curl "$BASE_URL/api/v1/storefront/vendor-terms/active"

Resposta

200Termos em vigor
json
{
  "id": "5d0b6f0e-3a1c-4c8e-9f7a-2b1c3d4e5f60",
  "title": "Termos de uso para sellers",
  "content": "<h2>1. Objeto</h2><p>Estes termos regulam a venda na loja...</p>",
  "version": 3,
  "is_active": true,
  "created_at": "2026-08-01T12:00:00Z"
}
200Nenhum termo publicado
json
{ "terms": null }

Campos da resposta

iduuid
Id da versão.
titlestring
Título.
contentstring
Texto dos termos em HTML. Sanitize antes de inserir na página.
versioninteger
Número da versão, crescente.
is_activeboolean
Sempre true nesta rota.
created_atstring
RFC 3339.
termsnull
Só existe quando não há termo publicado: o corpo vira { \"terms\": null }.

Erros

StatusQuandoCorpo
500Falha ao ler os termos.{"error":"TERMS_GET_FAILED","detail":"..."}
Dois formatos de resposta

Com termo publicado a resposta é o objeto do termo; sem termo ela é { \"terms\": null }. Teste body.terms === null ou a presença de id.

Veja também

  • Sellers e microsites
Anterior
Microsite
Próxima
B2B, preços e pedidos programados
Nesta página
  • Exemplo de requisição
  • Resposta
  • Erros
  • Veja também