Começando

Guia rápido

Da chave à primeira chamada em três passos.

1. Crie a chave

No painel da loja, abra Configurações › API e webhooks (hoteldaslojas.com.br/painel/api), dê um nome (ex.: “ERP”) e marque só as permissões de que o sistema precisa. A chave aparece uma única vez: copie e guarde num cofre de senhas ou variável de ambiente.

Use uma chave por sistema conectado. Se um deles for desligado, revogue só a chave dele.
A chave dá acesso aos dados da loja: nunca a coloque em código que roda no navegador do cliente.

2. Faça a primeira chamada

Guarde a chave numa variável de ambiente e consulte os dados da loja:

export HDL_CHAVE="hdl_live_..."

curl https://api.hoteldaslojas.com.br/v1/loja \
  --header "Authorization: Bearer $HDL_CHAVE"

{
  "dados": {
    "id": 220,
    "nome": "Página Dobrada",
    "descricao": "Livraria independente com curadoria: romances, ensaios, livros infantis, clássicos em capa dura, box de presente e acessórios de leitura.",
    "url": "https://demo73.hoteldaslojas.com.br",
    "subdominio": "demo73",
    "ativa": true,
    "contato": {
      "email": "[email protected]",
      "whatsapp": "(11) 97373-7373",
      "instagram": "paginadobrada.demo"
    },
    "endereco": {
      "cep": "85905-370",
      "rua": "Rua México",
      "numero": "123",
      "bairro": "Jardim Gisela",
      "complemento": "",
      "cidade": "Toledo",
      "estado": "Paraná"
    },
    "moeda": "BRL",
    "pedido_minimo": 10.0,
    "frete_gratis_a_partir": 149.0
  }
}

Ainda não tem loja? Use a chave de demonstração (somente leitura, loja exemplo):

curl https://api.hoteldaslojas.com.br/v1/produtos?por_pagina=3 \
  --header "Authorization: Bearer hdl_live_0d89ec3f4713ce7ac670e12f14afb33e47194d0a12bba0da"

3. Escolha o próximo passo

Importar pedidosLeve os pedidos para o ERP e devolva o rastreio. Sincronizar estoqueMantenha o saldo igual ao do seu depósito. Receber webhooksSeja avisado de cada pedido novo, sem consultar a API. Testar tudo de uma vezScripts que conferem cada endpoint com a sua chave.