A chave de storefront é pública por design, e por isso você pode colá-la no código da sua loja. O que a protege é o alcance: uma loja, três permissões, 60 requisições por minuto e uma revogação que corta na hora.

​
De onde ela sai

Você a emite no admin: Configurações → Chaves para o seu storefront → Gerar chave. Dá para ter várias ativas e ler qualquer uma de novo, então perdê-la não obriga a emitir outra. Se você é agência, gere uma chave por loja de cliente: assim revogar uma não afeta as outras.
Todas as chaves desta documentação são fictícias de propósito. Uma chave que parece real acaba copiada num repositório público.

​
O que uma chave pode fazer

Três coisas, e nada mais: Ela não configura a loja, não ativa momentos, não lê métricas nem cria conexões: isso fica no admin. A cota é de 60 requisições por minuto por chave; quem a copiar leva a cota daquela loja, não a da plataforma. A chave identifica uma única loja, e por isso a requisição não a leva. Veja o que a CrossUp decide.

​
Rotacionar sem derrubar

  1. Gere a chave nova no admin.
  2. Publique a sua loja com a nova.
  3. Revogue a antiga. A próxima requisição com ela já não entra.

​
Os erros da chave

Um 404 inesperado com uma chave válida quase sempre é a chave de outra loja, não um id errado. O formato de cada erro está em Erros.

Pedir recomendações

Cada momento com a sua requisição e o que volta.

Cota e cache

Como não gastar a cota em requisições que você já fez.