Começando

Autenticação

Chaves de acesso por loja, enviadas no cabeçalho Authorization.

Cabeçalho

Envie a chave em todas as chamadas:

Authorization: Bearer hdl_live_3f9a2c...

Formato da chave

As chaves começam com hdl_live_ seguido de 48 caracteres. No banco do Hotel das Lojas fica apenas o hash da chave: nem a nossa equipe consegue lê-la depois de criada. O painel mostra só o começo (ex.: hdl_live_3f9a2c…), para você reconhecer qual é qual.

Criar e revogar

O dono da loja cria e revoga chaves em Configurações › API e webhooks. A revogação vale na hora: a próxima chamada com aquela chave recebe 401 chave_invalida. Colaboradores da equipe não têm acesso a essa tela.

Boas práticas

Uma chave por sistema, só com os escopos necessários.
Guarde em variável de ambiente ou cofre de senhas, nunca no código-fonte nem no navegador.
Se suspeitar de vazamento, revogue e crie outra (o painel mostra o último uso e IP de cada chave).
Identifique o seu sistema no cabeçalho User-Agent (ex.: MeuERP/2.1 ([email protected])). Isso ajuda o suporte a localizar as suas chamadas.

Erros de autenticação

HTTP	código	o que fazer
401	`nao_autenticado`	Faltou o cabeçalho ou o formato `Bearer`.
401	`chave_invalida`	Chave errada ou revogada.
403	`sem_permissao`	A chave não tem o escopo do endpoint. Crie outra com o escopo.