Criar uma Edge Function local

Comece pelo ambiente local

Instale a CLI como dependência de desenvolvimento e inicialize o projeto conforme o guia de CLI deste hotsite. Com o runtime de containers ativo, gere uma função:

1
npx supabase functions new hello-world
2
npx supabase functions serve hello-world

Leia o arquivo criado em supabase/functions/hello-world/index.ts antes de modificá-lo. O template oficial pode mudar entre versões. Preserve o tratamento de autenticação gerado e use a chamada de exemplo indicada pela versão instalada.

Confira cabeçalhos e entrada

O quickstart consultado usa uma chave publishable no cabeçalho apikey. Uma chave publishable não é um JWT de sessão e não deve ser colocada como Bearer para simular um usuário. Quando a função exigir identidade, valide também a sessão conforme o contrato da função.

Envie uma requisição ao endpoint local exibido pela CLI. Confira o status HTTP, o JSON retornado e o log no terminal. Repita com entrada ausente e inválida. Defina respostas apropriadas para essas situações antes de conectar a função à interface.

Organize a lógica

Mantenha segredos em variáveis de ambiente próprias do servidor. Um arquivo local de ambiente não deve entrar no Git. A função deve validar o corpo recebido e limitar as operações permitidas ao usuário. Ter acesso a uma chave privilegiada dentro da função não autoriza atender qualquer solicitação do navegador.

Para chamadas vindas de outro domínio, configure CORS conforme a documentação. Faça uma operação curta por chamada e trate a repetição de requisições quando houver gravação. Rotinas demoradas precisam de uma estratégia própria de processamento.

Prepare a publicação

Registre a versão da CLI, o comando usado e o resultado observado. Antes de publicar, confira projeto de destino, segredos remotos e política de autenticação. Este guia termina no ambiente local: o deploy depende dessas configurações e de uma nova verificação no endereço remoto.