Saltar para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.replit.com/llms.txt

Use this file to discover all available pages before exploring further.

Compartilhe seu banco de dados entre múltiplos aplicativos expondo-o como uma API REST. Isso permite que outros aplicativos leiam e gravem seus dados com segurança por meio de requisições HTTP, mantendo tudo em um só lugar.

​
Adicione uma API ao seu aplicativo existente

Peça ao Agent para criar uma API REST para seu banco de dados. O Agent configurará endpoints, adicionará autenticação e protegerá seus dados.
1

Abra seu aplicativo

Abra o aplicativo que contém o banco de dados que você deseja compartilhar.
2

Peça ao Agent para criar a API

O Agent configurará tudo que você precisa automaticamente.
3

Adicione sua chave de API

  1. Abra a aba Secrets
  2. Adicione um secret: API_KEY com uma senha segura
  3. Esta chave protege seu banco de dados de acesso não autorizado
4

Publique seu aplicativo

  1. Selecione Executar para testar sua API
  2. Selecione Publicar > Autoscale para obter uma URL pública
  3. Seu banco de dados agora está acessível a outros aplicativos

​
Exemplo: Template de API de banco de dados

Veja um exemplo funcional com o template Database API Example. Faça um fork dele para iniciar uma nova API de banco de dados do zero ou explore o código para entender como funciona. O template inclui:
  • Configuração automática do banco de dados com dados de exemplo
  • Endpoints de API para todas as operações CRUD
  • Autenticação por chave de API
  • Drizzle ORM para consultas seguras
1

Faça um fork do template

Abra o template Database API Example e faça um fork dele.
2

Adicione uma chave de API

  1. Abra a aba Secrets
  2. Adicione API_KEY com uma senha segura
3

Execute e publique

  1. Selecione Executar para iniciar a API
  2. Selecione Publicar > Autoscale quando estiver pronto

​
Conecte-se de outros aplicativos

Peça ao Agent para escrever o código de conexão em qualquer um dos seus outros aplicativos: Certifique-se de substituir [SEU-APP] pelo nome do seu aplicativo. O Agent cuidará da autenticação e do tratamento de erros automaticamente, mantendo sua chave de API segura no servidor.

​
Referência de endpoints de API

Seu banco de dados usa endpoints REST padrão. Para uma tabela items:
AçãoMétodoEndpoint
Listar todosGET/api/items
Obter umGET/api/items/:id
CriarPOST/api/items
AtualizarPUT/api/items/:id
ExcluirDELETE/api/items/:id
Todas as requisições precisam de um cabeçalho X-API-KEY com sua chave de API.

​
Escreva seu próprio código de conexão

Se preferir codificar a conexão você mesmo, use estes exemplos de back-end: 
const API_URL = 'https://seu-app.replit.app';
const API_KEY = process.env.API_KEY;

const response = await fetch(`${API_URL}/api/items`, {
  headers: { 'X-API-KEY': API_KEY }
});
const items = await response.json();
Estes exemplos são apenas para código de back-end. Nunca use chaves de API em código front-end/navegador — elas serão expostas a qualquer pessoa que visualize o código-fonte da sua página. Para aplicativos front-end, crie um endpoint de back-end que faça proxy das requisições para sua API de banco de dados.Sempre armazene sua chave de API em Secrets, não no seu código.

​
Adicione mais tabelas

Expanda seu banco de dados conforme seu aplicativo cresce: O Agent atualizará seu esquema, criará endpoints e aplicará autenticação automaticamente.

​
Como funciona

Sua API atua como um hub central. Quando um aplicativo precisa de dados, ele envia uma requisição para sua API. A API verifica a chave de API e então lê ou grava no seu banco de dados. Múltiplos aplicativos compartilham um único banco de dados com segurança.

​
Segurança

Sua API inclui proteção integrada:
  • Autenticação por chave de API: Apenas aplicativos com a chave correta podem acessar seu banco de dados
  • Proteção contra injeção de SQL: O Drizzle ORM evita consultas maliciosas
  • Validação de dados: A API verifica todos os dados antes de salvar
Armazene sua chave de API em Secrets, nunca no código.
Compartilhe sua chave de API apenas com aplicativos em que você confia.

​
Solução de problemas

  • Publique seu aplicativo de API de banco de dados (não apenas execute-o)
  • Use sua URL publicada terminando em .replit.app
  • Verifique se ambos os aplicativos têm a mesma chave de API em Secrets
  • Verifique se o secret se chama API_KEY em ambos os aplicativos
  • Armazene a chave de API em Secrets, não no código
  • Verifique se a chave de API é a mesma em ambos os aplicativos
  • Verifique se o secret se chama API_KEY (tudo em maiúsculas)
Peça ao Agent para solucionar o problema:

​
Próximos passos