From bd7d8d47092851d9fea034437ad8832dcf9faa3a Mon Sep 17 00:00:00 2001 From: rodolpho Date: Wed, 6 May 2026 14:04:15 -0300 Subject: [PATCH] Atualizando guia com o IP real do Tailscale --- Acesso-Externo-e-Integracao.md | 45 ++++++++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 Acesso-Externo-e-Integracao.md diff --git a/Acesso-Externo-e-Integracao.md b/Acesso-Externo-e-Integracao.md new file mode 100644 index 0000000..bf946c1 --- /dev/null +++ b/Acesso-Externo-e-Integracao.md @@ -0,0 +1,45 @@ +# Guia de Acesso Externo e Integração de Dados (Dados Reais) + +Este documento descreve como consumir os dados do projeto **apitdn** utilizando o IP real da sua VPN Mesh (Tailscale). + +## 🌐 1. Infraestrutura de Conexão +O seu Raspberry Pi está acessível através do Tailscale pelo IP fixo abaixo: + +* **IP Tailscale**: `100.127.147.8` +* **Endereço Web Externo**: [http://100.127.147.8:3000](http://100.127.147.8:3000) + +## 🛠️ 2. Métodos de Consumo de Dados + +### A. Clonagem via Git +Para baixar a base completa (~640MB) em qualquer máquina da sua rede Tailscale: +```bash +git clone http://100.127.147.8:3000/rodolpho/apitdn.git +``` + +### B. Download de Snapshot (ZIP) +Para baixar a versão mais recente dos arquivos Markdown sem o histórico do Git: +* **URL**: [http://100.127.147.8:3000/rodolpho/apitdn/archive/master.zip](http://100.127.147.8:3000/rodolpho/apitdn/archive/master.zip) + +### C. Acesso aos Arquivos Raw (Markdown Puro) +Para ler a documentação diretamente via URL (substitua o caminho conforme necessário): +* **Exemplo**: `http://100.127.147.8:3000/rodolpho/apitdn/raw/branch/master/fluig_rag_docs/README.md` + +## 🤖 3. Integração com LLMs Externas (RAG) +Protocolo para agentes de IA que precisam acessar esta base de conhecimentos: + +### Passo 1: Autenticação (PAT) +Gere um token em `Configurações > Aplicativos` e utilize no header das requisições. + +### Passo 2: Chamada de API para Conteúdo +Para buscar a lista de arquivos ou o conteúdo de um diretório: +`GET http://100.127.147.8:3000/api/v1/repos/rodolpho/apitdn/contents/fluig_rag_docs` + +### Passo 3: Header de Autorização +```http +Authorization: token [SEU_TOKEN_PAT] +Accept: application/json +``` + +## 🔒 Segurança +* O acesso só é permitido para dispositivos autenticados na sua rede Tailscale. +* O servidor Gitea está rodando no usuário `gitea` no Raspberry Pi, isolado do sistema principal.