Delete page "Acesso-Externo-e-Integracao"
@@ -1,45 +0,0 @@
|
|||||||
# 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.
|
|
||||||
Reference in New Issue
Block a user