SDKs e Bibliotecas
SDKs oficiais da Liqi estão em desenvolvimento. Eles vão simplificar a integração com nossas APIs, oferecendo clients type-safe, autenticação automática e tratamento de erros robusto. Enquanto isso, você pode usar a REST API diretamente com qualquer linguagem.
Roadmap de SDKs
Node.js / TypeScript SDK
Q2 2026Primeiro SDK oficial. Suporte completo a todas as APIs (Public, TIDC v1, CaaS) com tipagem TypeScript nativa e compatibilidade com ESM e CommonJS.
Python SDK
Q3 2026SDK para Python 3.10+. Ideal para integrações de backend, automação e análise de dados. Suporte a async/await via httpx.
Go SDK
Q4 2026SDK para Go 1.21+. Otimizado para alta performance e microsserviços. Structs tipadas e interface idiomática.
Datas estimadas
As datas acima são estimativas e podem ser ajustadas. Cadastre-se para receber notificações quando um SDK for lançado.
Recursos planejados
Todos os SDKs incluirão os seguintes recursos:
Clients type-safe
Tipos gerados automaticamente a partir das specs OpenAPI, garantindo que seu código esteja sempre sincronizado com a API.
Autenticação automática
Gerenciamento automático de tokens, refresh e assinatura de requests. Basta configurar suas credenciais uma vez.
Verificação de webhooks
Helpers para validar assinaturas HMAC de webhooks, protegendo sua aplicação contra payloads forjados.
Retry com backoff exponencial
Tratamento automático de erros transientes (429, 500, 502, 503) com retries configuráveis e jitter.
Enquanto isso
Você não precisa esperar os SDKs para começar a integrar. A REST API da Liqi funciona com qualquer linguagem. Veja como:
Quickstart
Sua primeira chamada em 5 minutos
Referência da API
Documentação completa de todos os endpoints
Geração automática de clients
Nossas APIs possuem specs OpenAPI disponíveis. Você pode usar ferramentas como openapi-generator, openapi-typescript ou swagger-codegen para gerar clients automaticamente na sua linguagem preferida.
Exemplo: chamada direta à API
Este é o código que você precisa escrever hoje para fazer uma chamada autenticada:
import crypto from "crypto";
const BASE_URL = "https://api.liqi.com.br";
const API_KEY = process.env.LIQI_API_KEY!;
const API_SECRET = process.env.LIQI_API_SECRET!;
async function liqiRequest(method: string, path: string, body?: object) {
const timestamp = new Date().toISOString();
const payload = body ? JSON.stringify(body) : "";
// sign the request
const message = `${method}\n${path}\n${timestamp}\n${payload}`;
const signature = crypto
.createHmac("sha256", API_SECRET)
.update(message)
.digest("hex");
const response = await fetch(`${BASE_URL}${path}`, {
method,
headers: {
"Content-Type": "application/json",
"X-API-Key": API_KEY,
"X-Timestamp": timestamp,
"X-Signature": signature,
},
body: payload || undefined,
});
if (!response.ok) {
throw new Error(`API error: ${response.status} ${response.statusText}`);
}
return response.json();
}
// usage
const tranches = await liqiRequest("GET", "/public/tranches?status=ACTIVE");
console.log(`Found ${tranches.count} active tranches`);Preview: com o SDK
Com o SDK, o mesmo resultado será alcançado com muito menos código:
import { Liqi } from "@liqi/sdk";
// with the SDK (coming soon)
const liqi = new Liqi({
apiKey: process.env.LIQI_API_KEY!,
apiSecret: process.env.LIQI_API_SECRET!,
});
// type-safe, auto-authenticated, with retry logic
const tranches = await liqi.tranches.list({ status: "ACTIVE" });
console.log(`Found ${tranches.count} active tranches`);
// webhook signature verification built-in
const isValid = liqi.webhooks.verifySignature(payload, signature);Receba novidades
Quer ser notificado quando um SDK for lançado? Envie um email para o time de developer relations:
Quero ser notificado