shop.loja.config
Configuração pública de marca, contatos, políticas, avisos, rodapé, formas de pagamento anunciadas e aparência.
Exemplos seguros e fictícios. O domínio
example.invalid e a credencial demonstrativa abaixo não funcionam. Use o token real somente no servidor da sua integração e nunca o inclua em páginas públicas.Parâmetros
Este método não exige parâmetros no corpo da requisição.
Exemplos fictícios
Os exemplos documentam o formato; eles não executam nenhuma operação.
Requisição
cURL demonstrativo
curl --request POST \
'https://example.invalid/api/v1/CREDENCIAL_FICTICIA_SEM_VALOR/shop.loja.config' \
--header 'Content-Type: application/json' \
--data '{}'
Corpo JSON
{}Resposta HTTP 200
{
"ok": true,
"method": "shop.loja.config",
"result": {
"nome": "Loja de demonstração",
"logo_url": "https://assets.example.com/logo.png",
"logo_quadrada_url": "https://assets.example.com/logo-square.png",
"descricao": "Descrição ilustrativa.",
"slogan": null,
"cores": {
"principal": "#2684ff",
"texto": "#0f1621"
},
"contato": {
"whatsapp": null,
"email": "loja@example.com",
"endereco": null,
"telefone": null,
"cnpj": null
},
"busca_placeholder": null,
"rodape": {
"colunas": null
},
"topbar": {
"avisos": [],
"frete_gratis_acima": null,
"desconto_pix": null,
"atacado_url": null,
"atendimento": null
},
"pagamentos": [
"pix"
],
"politicas": {
"troca": null,
"privacidade": null,
"entrega": null
},
"aparencia": {
"cores": {
"fundo": null,
"superficie": null,
"botao": null,
"botao_texto": null
},
"fonte": null,
"banner": {
"ativo": false,
"titulo": null,
"subtitulo": null,
"imagem_url": null,
"cta_texto": null,
"cta_url": null
},
"destaques": {
"ativo": false,
"titulo": null,
"skus": []
}
},
"completa": true
}
}Erros
| HTTP | Código | Condição |
|---|---|---|
| 403 | TOKEN_NO_COMPANY | Token sem empresa associada. |
Consulte também os erros globais e limites.
Observações
- Campos não configurados podem ser null, arrays vazios ou blocos com defaults. completa exige nome e logo própria da loja: a implementação atual não considera a logo herdada da empresa nesse indicador.
- Nome e logo podem usar fallback da empresa. URLs de logo devem ser HTTP(S) absolutas.
- topbar.avisos é lista resolvida de {texto,destaque?,url?}. rodape.colunas é null ou lista de {titulo,links:[{rotulo,url?}]}. Lista vazia é escolha explícita de não mostrar colunas.
- pagamentos descreve meios anunciados: pix, visa, mastercard, elo, amex, hipercard e boleto. Não é consulta da capacidade efetiva do gateway.
- Aparência inclui fonte inter, poppins, roboto, lato, playfair ou system (ou null), banner e até 24 SKUs de destaque.
- Políticas são conteúdo textual cadastrado pela loja; renderize como texto seguro.