Produtos

Obter Produto

Retorna um produto com imagens, estoque e variações

GET

/v1/produtos/{id}

Escopo

produtos.ler

Autorização

Authorizationstringobrigatórioheader

Chave da API no formato Bearer hdl_live_.... Crie no painel da loja em Integração › API e webhooks. Saiba mais.

Parâmetros de caminho

idintegerobrigatóriopath

Identificador do produto.

Resposta

200 — objeto { "dados": {...} } com um Produto.

Erros possíveis

HTTP	código	quando
`401`	`nao_autenticado`	Faltou o cabeçalho Authorization: Bearer <chave>.
`401`	`chave_invalida`	Chave inexistente ou revogada.
`403`	`sem_permissao`	A chave não tem o escopo exigido pelo endpoint.
`404`	`nao_encontrado`	O recurso não existe nesta loja.
`404`	`rota_nao_encontrada`	Endereço inexistente na API v1.

Requisição

curl --request GET \
  --url 'https://api.hoteldaslojas.com.br/v1/produtos/2496' \
  --header 'Authorization: Bearer <chave>'

const resposta = await fetch('https://api.hoteldaslojas.com.br/v1/produtos/2496', {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${process.env.HDL_CHAVE}`
  }
});

if (!resposta.ok) throw new Error((await resposta.json()).erro?.mensagem);
const { dados } = await resposta.json();
console.log(dados);

import os, requests

resposta = requests.get(
    "https://api.hoteldaslojas.com.br/v1/produtos/2496",
    headers={"Authorization": f"Bearer {os.environ['HDL_CHAVE']}"},
    timeout=30,
)
resposta.raise_for_status()
print(resposta.json()["dados"])

<?php
$ch = curl_init('https://api.hoteldaslojas.com.br/v1/produtos/2496');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('HDL_CHAVE')],
]);
$resposta = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
print_r($resposta);

Resposta

{
  "dados": {
    "id": 2496,
    "sku": "LIV-001",
    "nome": "O Farol das Horas Quietas",
    "descricao": "",
    "marca": "Página Dobrada",
    "categoria_id": 783,
    "preco": 59.9,
    "preco_promocional": 39.9,
    "preco_final": 39.9,
    "ativo": true,
    "visivel": false,
    "estoque": {
      "controlado": true,
      "quantidade": 7,
      "minimo": 0
    },
    "peso_kg": 0.0,
    "dimensoes_cm": {
      "altura": 0.0,
      "largura": 0.0,
      "comprimento": 0.0
    },
    "imagens": [],
    "variacoes": [
      {
        "nome": "Edição",
        "escolha_minima": 1,
        "escolha_maxima": 1,
        "opcoes": [
          {
            "nome": "Brochura",
            "descricao": "",
            "valor_adicional": 0.0,
            "cor": null,
            "estoque": null,
            "sku": null
          },
          {
            "nome": "Capa dura",
            "descricao": "",
            "valor_adicional": 20.0,
            "cor": null,
            "estoque": 4,
            "sku": "LIV-001-CD"
          }
        ]
      }
    ],
    "url": "https://demo73.hoteldaslojas.com.br/produto/2496-livro-teste-api",
    "criado_em": "2026-10-28T00:43:26-03:00",
    "atualizado_em": "2026-10-28T00:43:29-03:00"
  }
}

{
  "erro": {
    "codigo": "chave_invalida",
    "mensagem": "Chave da API inválida ou revogada.",
    "request_id": "req_1b9c7d2e3f4a5b6c"
  }
}

{
  "erro": {
    "codigo": "sem_permissao",
    "mensagem": "Esta chave não tem o escopo \"pedidos.ler\". Crie uma chave com esse escopo no painel da loja (Integração › API).",
    "request_id": "req_95f4a872c180063c"
  }
}

{
  "erro": {
    "codigo": "nao_encontrado",
    "mensagem": "Pedido não encontrado nesta loja.",
    "request_id": "req_6b6e2da7f1bb1871"
  }
}