Guia de Conexão BuhDrive

01 Variáveis de Ambiente (Dashboard)

No Dashboard da BuhCloud, você VITALMENTE precisa cadastrar estas chaves:

BUHDRIVE_API_KEY Sua chave pública

BUHDRIVE_API_SECRET Seu segredo privado

BUHDRIVE_BASE_URL https://buzinha.infinitdaw.site/buhdrive

⚠️

Dica de Ouro: Nunca coloque essas chaves direto no código. Use sempre process.env para mantê-las seguras e fáceis de mudar sem mexer no script.

02 Conectando ao Backend do BuhDrive

Para o seu app "falar" com o BuhDrive, ele precisa atuar como um intermediário seguro. O processo segue este fluxo:

SEU FRONTEND

Caminho: fetch('api/files')

➔

SEU BACKEND

Adiciona as Chaves Secretas

➔

BUHDRIVE API

Retorna os Arquivos

Implementação Recomendada (Axios)

// No seu server.ts
app.get('/api/buhdrive/files', async (req, res) => {
  try {
    const response = await axios.get(`${process.env.BUHDRIVE_BASE_URL}/api/files`, {
      headers: {
        'X-API-Key': process.env.BUHDRIVE_API_KEY,
        'X-API-Secret': process.env.BUHDRIVE_API_SECRET,
        'Accept': 'application/json'
      }
    });
    res.json(response.data);
  } catch (error) {
    res.status(500).json({ error: 'Erro ao conectar ao BuhDrive' });
  }
});

🤖 Prompt Mestre para Criar seu App

Copie o texto abaixo e mande para o Claude, ChatGPT ou Gemini. Ele já contém todas as regras da BuhCloud para seu app nascer 100% funcional.

Prompt de Configuração

"Estou desenvolvendo um aplicativo para a plataforma BuhCloud. Por favor, siga rigorosamente estas regras: 
1. Nunca use a porta 3000 fixa; sempre use 'process.env.PORT || 3000'. 
2. O servidor deve ouvir em '0.0.0.0' para ser acessível externamente. 
3. No package.json, defina o script 'start' apontando para o seu arquivo principal (ex: node server.js). 
4. Use caminhos RELATIVOS no fetch do frontend (ex: 'api/data' em vez de '/api/data') para evitar erros de roteamento na nuvem.
5. Integre o BuhDrive usando as variáveis BUHDRIVE_API_KEY, BUHDRIVE_API_SECRET e BUHDRIVE_BASE_URL. Passe essas chaves via HEADERS ('X-API-Key' e 'X-API-Secret') em chamadas de BACKEND para BACKEND.
6. Nunca exponha chaves de API no Frontend.

[DESCREVA SEU APP AQUI - Ex: Quero uma loja de drones que lista arquivos do BuhDrive]"

Substitua o texto entre colchetes pela sua ideia e veja a mágica acontecer!

03 Erros Comuns (O Pesadelo)

❌ Erro 401: Unauthorized

A API te expulsou porque você esqueceu as chaves ou as enviou no lugar errado (no body em vez de headers).

Fix: Verifique se BUHDRIVE_API_KEY está definida.

❓ Erro 404: Not Found

Você está tentando acessar uma porta que não existe ou uma URL relativa que quebrou no ambiente de produção.

Fix: Use caminhos como 'v1/api' e não '/api'.

04 Frontend: O Segredo da URL Relativa

Na BuhCloud, o app roda em sub-pastas dinâmicas. Use caminhos sem a barra inicial no fetch:

❌ Errado

fetch('/api/products')

Tenta buscar na raiz do domínio, ignorando o proxy da Cloud.

✅ Certo

fetch('api/products')

Busca relativo à pasta onde o app está rodando. Seguro e estável.