Finexis'i kendi ürününüze entegre edin
REST API, webhook'lar, OAuth 2.0 ve resmi SDK'lar. Sandbox ortamı dakikalar içinde, üretim erişimi günler içinde.
Platform özellikleri
REST API
JSON tabanlı, OpenAPI 3.1 spesifikasyonu, sürüm yönetimli endpoint'ler.
Webhook'lar
Senaryo değişimi, eşik aşımı, entegrasyon hatası — gerçek zamanlı event push.
OAuth 2.0
Authorization Code + PKCE akışı, scope bazlı izinler, refresh token.
Rate limit
Sandbox: 60 req/dk · Production: 600 req/dk · Enterprise: özel limit.
İmzalı webhook
HMAC-SHA256 imzası, replay koruması için timestamp doğrulama.
Versioning
URL bazlı versiyonlama (/v1, /v2). Deprecation süreci minimum 12 ay.
Hızlı başlangıç
import { Finexis } from "@finexis/sdk";
const client = new Finexis({
apiKey: process.env.FINEXIS_API_KEY,
});
const scenario = await client.scenarios.create({
name: "Q1 2026 Genişleme",
horizon_weeks: 26,
assumptions: {
revenue_growth: 0.18,
fx_eur_try: 38.5,
new_hires: 4,
},
});
const result = await client.scenarios.simulate(scenario.id);
console.log(result.cashflow);
console.log(result.runway_weeks);// Webhook imza doğrulama (Express)
import crypto from "crypto";
app.post("/finexis-webhook", (req, res) => {
const signature = req.header("X-Finexis-Signature");
const expected = crypto
.createHmac("sha256", process.env.FINEXIS_WEBHOOK_SECRET)
.update(JSON.stringify(req.body))
.digest("hex");
if (signature !== expected) {
return res.status(401).send("Invalid signature");
}
// event işleme
const { type, data } = req.body;
console.log(`[${type}]`, data);
res.status(200).send("ok");
});Resmi SDK'lar
npm install @finexis/sdkpip install finexiscomposer require finexis/sdkgo get github.com/finexis/finexis-goÖne çıkan endpoint'ler
| Method | Endpoint |
|---|---|
| POST | /v1/scenarios |
| GET | /v1/scenarios/{id} |
| POST | /v1/scenarios/{id}/simulate |
| GET | /v1/cashflow/forecast |
| GET | /v1/integrations |
| POST | /v1/webhooks |
Webhook event'leri
scenario.createdYeni senaryo kaydedildiğinde tetiklenir.
scenario.simulatedBir senaryo başarıyla koşturulduğunda.
alert.threshold_breachedNakit eşiği, marj veya KDV rezervi aşıldığında.
integration.sync_failedBir entegrasyon senkron sırasında hata aldığında.
https://api-sandbox.usefinexis.com/v1Test verisi, sıfır maliyet, sınırsız hesap.
https://api.usefinexis.com/v1Ücretli plan + güvenlik incelemesi sonrası aktif olur.
İlk istek 15 dakikada
Sandbox API anahtarınızı şimdi alın, ilk simülasyonunuzu kodla koşturun.