Gravar texto do produto

Grava o texto próprio de um produto nesta loja.

PUT/v1/loja-hub/seo/produtos/{sku}

Corpo

Parâmetro	Tipo	Padrão	Descrição
`sku` obrigatório	texto	—	O SKU do produto, no caminho.
`titulo` obrigatório	texto	—	De 3 a 70 caracteres.
`descricao` obrigatório	texto	—	De 10 a 160 caracteres.
`texto`	texto	—	Até 2000 caracteres.
`palavrasChave`	lista	—	Até 20 termos, com até 40 caracteres cada.
`publicar`	booleano	—	Padrão `true`. `false` grava como rascunho.

Exemplo

curl -X PUT "https://api.otlshoes.com.br/v1/loja-hub/seo/produtos/320" \
  -H "Authorization: Bearer otl_prod_SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "titulo": "Tênis Adidas Forum Low Branco",
  "descricao": "Clássico do basquete dos anos 80, em couro branco. Calça normal.",
  "publicar": true
}'

curl -X PUT "https://api-sandbox.otlshoes.com.br/v1/loja-hub/seo/produtos/320" \
  -H "Authorization: Bearer otl_sbx_SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "titulo": "Tênis Adidas Forum Low Branco",
  "descricao": "Clássico do basquete dos anos 80, em couro branco. Calça normal.",
  "publicar": true
}'

const resposta = await fetch('https://api.otlshoes.com.br/v1/loja-hub/seo/produtos/320', {
  method: 'PUT',
  headers: {
    Authorization: 'Bearer otl_prod_SEU_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "titulo": "Tênis Adidas Forum Low Branco",
    "descricao": "Clássico do basquete dos anos 80, em couro branco. Calça normal.",
    "publicar": true
  }),
});

if (!resposta.ok) {
  const { erro } = await resposta.json();
  throw new Error(`${erro.codigo}: ${erro.mensagem} (${erro.requestId})`);
}
const dados = await resposta.json();

const resposta = await fetch('https://api-sandbox.otlshoes.com.br/v1/loja-hub/seo/produtos/320', {
  method: 'PUT',
  headers: {
    Authorization: 'Bearer otl_sbx_SEU_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "titulo": "Tênis Adidas Forum Low Branco",
    "descricao": "Clássico do basquete dos anos 80, em couro branco. Calça normal.",
    "publicar": true
  }),
});

if (!resposta.ok) {
  const { erro } = await resposta.json();
  throw new Error(`${erro.codigo}: ${erro.mensagem} (${erro.requestId})`);
}
const dados = await resposta.json();

<?php
$ch = curl_init('https://api.otlshoes.com.br/v1/loja-hub/seo/produtos/320');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PUT');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer otl_prod_SEU_TOKEN',
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'titulo' => 'Tênis Adidas Forum Low Branco',
    'descricao' => 'Clássico do basquete dos anos 80, em couro branco. Calça normal.',
    'publicar' => true,
]));

$corpo = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status >= 400) {
    throw new Exception($corpo['erro']['codigo'] . ': ' . $corpo['erro']['mensagem']);
}

<?php
$ch = curl_init('https://api-sandbox.otlshoes.com.br/v1/loja-hub/seo/produtos/320');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PUT');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer otl_sbx_SEU_TOKEN',
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'titulo' => 'Tênis Adidas Forum Low Branco',
    'descricao' => 'Clássico do basquete dos anos 80, em couro branco. Calça normal.',
    'publicar' => true,
]));

$corpo = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status >= 400) {
    throw new Exception($corpo['erro']['codigo'] . ': ' . $corpo['erro']['mensagem']);
}

import requests

resposta = requests.put(
    "https://api.otlshoes.com.br/v1/loja-hub/seo/produtos/320",
    headers={
        "Authorization": "Bearer otl_prod_SEU_TOKEN",
    },
    json={
        "titulo": "Tênis Adidas Forum Low Branco",
        "descricao": "Clássico do basquete dos anos 80, em couro branco. Calça normal.",
        "publicar": True
    },
    timeout=30,
)

if not resposta.ok:
    erro = resposta.json()["erro"]
    raise RuntimeError(f'{erro["codigo"]}: {erro["mensagem"]} ({erro["requestId"]})')
dados = resposta.json()

import requests

resposta = requests.put(
    "https://api-sandbox.otlshoes.com.br/v1/loja-hub/seo/produtos/320",
    headers={
        "Authorization": "Bearer otl_sbx_SEU_TOKEN",
    },
    json={
        "titulo": "Tênis Adidas Forum Low Branco",
        "descricao": "Clássico do basquete dos anos 80, em couro branco. Calça normal.",
        "publicar": True
    },
    timeout=30,
)

if not resposta.ok:
    erro = resposta.json()["erro"]
    raise RuntimeError(f'{erro["codigo"]}: {erro["mensagem"]} ({erro["requestId"]})')
dados = resposta.json()

Testar agora no ambiente de testes

A chamada é feita de verdade, do seu navegador para a API de testes (https://api-sandbox.otlshoes.com.br/v1). Use um token otl_sbx_…: ele fica só nesta aba, e some ao fechá-la. Token de produção não é aceito aqui.

Token de testePUTCorpo (JSON)

Resposta

200 OK, com o texto gravado:

{
  "sku": "320",
  "endereco": "tenis-adidas-forum-low-branco-320",
  "titulo": "Tênis Adidas Forum Low Branco",
  "descricao": "Clássico do basquete dos anos 80, em couro branco. Calça normal.",
  "texto": "O Forum Low nasceu nas quadras e virou peça de rua. Cabedal em couro, tira no tornozelo e solado de borracha.",
  "palavrasChave": [
    "adidas forum low",
    "tênis branco masculino"
  ],
  "origem": "MANUAL",
  "publicado": true,
  "publicadoEm": "2026-09-20T11:00:00-03:00",
  "atualizadoEm": "2026-09-20T11:00:00-03:00"
}

Regras que não se leem no JSON

Substitui o texto inteiro: o campo opcional que não vier fica vazio.
Entra como MANUAL, e a geração por IA do painel não o sobrescreve.
Escreva um texto diferente para cada loja. O mesmo texto em várias lojas do mesmo domínio é conteúdo duplicado, e prejudica todas na busca.
Gerar texto com IA não está na API: usa o crédito da chave do parceiro, e é feito no painel.

Erros possíveis

HTTP	`codigo`	Quando
400	`VALIDACAO`	Título ou descrição fora do tamanho, lista inválida
404	`NAO_ENCONTRADO`	O SKU não existe no catálogo
403	`LOJA_HUB_NAO_LIBERADA`	A OTL ainda não liberou a loja no HUB para este parceiro
403	`ESCOPO_INSUFICIENTE`	A integração não tem `loja-hub:escrever`