Começo

Autenticação

Toda chamada leva uma chave de API da loja no cabeçalho Authorization.

Cabeçalho

Authorization: Bearer zv_sk_SUA_CHAVE

A chave começa com zv_sk_ e pertence a uma loja só: não precisa dizer qual loja na chamada. Cada chave tem as próprias permissões e pode ser revogada sem afetar as outras.

Criar uma chave

No painel, abra Integrações › Chaves de API.
Clique em Nova chave, dê um nome (onde ela vai ser usada) e marque as permissões. Os atalhos “Só ver”, “Tudo” e “Nenhuma” ajudam.
Copie a chave na hora: ela aparece uma vez só. A Zolvi guarda só um resumo (hash) dela.

Perdeu a chave ou ela vazou? Revogue no painel (ela para de funcionar na hora) e crie outra. Cada loja pode ter até 20 chaves ativas.

Testar a chave

GET /store não pede permissão: devolve a loja e as permissões da própria chave.

curl

curl https://zolvibot.app/api/v1/store -H "Authorization: Bearer zv_sk_SUA_CHAVE"

Quando a chave não serve

Código	Quando
401	Sem cabeçalho Authorization, chave em formato errado, desconhecida ou revogada.
402	A loja está sem plano ativo ou suspensa. Renove o plano no painel.
403	A chave não tem a permissão da rota. A mensagem diz qual falta (ex.: `products:update`).

A API é para servidor falar com servidor: não há CORS. Use a chave no seu backend, nunca no navegador.