Ambientes e chaves

Cada projeto seu no Notyfacil tem dois ambientes: desenvolvimento e produção. Eles não compartilham nada. Consumers, tipos de evento, endpoints, eventos, entregas e fontes de recebimento pertencem a um ambiente só, e nenhuma chamada enxerga o que é do outro.

A chave diz o ambiente

A autenticação é uma chave de API no header Authorization, e é a chave que decide em qual ambiente a chamada acontece.

Authorization: Bearer whk_live_xxxxxxxxxxxxxxxxxxxx

Prefixo	Ambiente
whk_test_	Desenvolvimento
whk_live_	Produção

Não há parâmetro de ambiente em rota nenhuma: trocar de ambiente é trocar de chave. Um id de produção consultado com uma chave de desenvolvimento responde 404, exatamente como um id que não existe.

O que muda entre os dois

Quase nada, de propósito: o ambiente de desenvolvimento existe para você integrar exatamente o que vai rodar em produção. A diferença é uma:

• Em produção, a URL de endpoint e de destino precisa ser https. Em desenvolvimento, http é aceito. As outras regras de URL valem nos dois: portas 80 e 443, sem credenciais embutidas, e o host não pode resolver para rede privada.

A chave é de servidor

Cuidado

Quem tem a chave publica eventos e lê todo o histórico do ambiente, inclusive os data que você mandou. Ela não vai para navegador, aplicativo móvel nem repositório de código.

Guarde-a como você guarda a senha do banco: em variável de ambiente ou num cofre de segredos. Se ela vazar, crie outra no painel e revogue a antiga. Chave revogada responde 401 na hora.

Limite de requisições

O limite por segundo é do plano da organização, e todas as chaves da organização dividem o mesmo balde. Duas aplicações suas com chaves diferentes consomem o mesmo limite. Os números estão em limites.