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

Resposta

200Termos em vigor
200Nenhum termo publicado

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
bash
curl "$BASE_URL/api/v1/storefront/vendor-terms/active"
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"
}
json
{ "terms": null }