LiqiDevelopers
Em breve

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 2026

Primeiro 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 2026

SDK 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 2026

SDK 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:

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:

Node.js / TypeScript (sem SDK)
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:

Node.js / TypeScript (com SDK)
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