BelkAPI — BelkLang

Protocolos

Quando usar cada modo

BelkAPI suporta três protocolos — escolha pelo cenário de uso.

HTTP/1.1

Compatibilidade universal

Padrão da web. Funciona em qualquer cliente, ferramenta ou linguagem sem configuração extra.

Ideal para: scripts, ferramentas internas, curl, integrações simples

HTTP/2

Multiplexação e compressão

Múltiplas requisições em paralelo por uma única conexão TCP. Headers comprimidos com HPACK.

Ideal para: dashboards, apps com muitas chamadas simultâneas

HTTP/3 QUIC

Zero RTT e tolerância a falhas

Baseado em UDP. Sem head-of-line blocking. Conexões retomadas sem handshake em redes instáveis.

Ideal para: IoT, dispositivos móveis, redes com alta latência

Exemplos

Integrando com BelkAPI

Como consumir as rotas em diferentes linguagens.

// Chamada à rota /eolica com BelkLang
var params := {
    vento: 12,
    area:  50,
    rho:   1.225
}

var resp := belkapi.get("/eolica", params)

// resp.dado.potencia_w  → 31222.8
escrever(resp.dado.potencia_w)

// POST com body JSON
var sessao := belkapi.post("/sessao", {
    tipo: "geofisica"
})
escrever(sessao.id)

// Rust — usando reqwest
use reqwest::blocking::Client;
use serde_json::Value;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();

    // GET /eolica
    let resp: Value = client
        .get("http://localhost:8787/eolica")
        .query(&[("vento","12"),("area","50"),("rho","1.225")])
        .send()?
        .json()?;

    println!("Potência: {}", resp["potencia_w"]);
    Ok(())
}

# GET /saude
curl http://localhost:8787/saude

# GET /eolica com parâmetros
curl "http://localhost:8787/eolica?vento=12&area=50&rho=1.225"

# GET /solar
curl "http://localhost:8787/solar?lat=-8.05&area=10&eficiencia=0.2"

# GET /onda
curl "http://localhost:8787/onda?freq=0.1&l=2.0"

# POST /sessao com JSON
curl -X POST http://localhost:8787/sessao \
  -H "Content-Type: application/json" \
  -d '{"tipo": "geofisica"}'