Developer Platform

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ıç

İlk senaryonuzu koşturunTypeScript
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ğrulamaNode.js
// 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

TypeScript / Node.js
@finexis/sdk
npm install @finexis/sdk
Python
finexis
pip install finexis
PHP
finexis/sdk
composer require finexis/sdk
Go
finexis-go
go get github.com/finexis/finexis-go

Öne çıkan endpoint'ler

MethodEndpoint
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.created

Yeni senaryo kaydedildiğinde tetiklenir.

scenario.simulated

Bir senaryo başarıyla koşturulduğunda.

alert.threshold_breached

Nakit eşiği, marj veya KDV rezervi aşıldığında.

integration.sync_failed

Bir entegrasyon senkron sırasında hata aldığında.

Sandbox
https://api-sandbox.usefinexis.com/v1

Test verisi, sıfır maliyet, sınırsız hesap.

Production
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.