ECOSIRE Geliştirici Portalı

Kapsamlı REST API'miz ile güçlü entegrasyonlar oluşturun. 818+ uç nokta, tam OpenAPI spesifikasyonu ve TypeScript SDK.

API Belgelerini Görüntüle API Anahtarını Alın

818+

API Uç Noktaları

Modüller

REST

Mimarlık

Desteklenen Yerel Ayarlar

API

Hızlı Başlangıç

ECOSIRE API ile dakikalar içinde çalışmaya başlayın

Kimlik doğrulama

API erişimi için bir JWT taşıyıcı jetonu almak üzere Authentik veya API anahtarları aracılığıyla OAuth2'yi kullanın.

POST /api/auth/login

İlk Aramanızı Yapın

Herhangi bir API uç noktasını çağırmak için Yetkilendirme başlığındaki taşıyıcı belirtecini kullanın.

# Tüm kişileri listele

curl -H "Authorization: Bearer $TOKEN" \

https://api.ecosire.com/api/contacts

SDK'yı kullanın

Yerleşik hata işleme özelliğine sahip, tür açısından güvenli API çağrıları için TypeScript SDK'mızı yükleyin.

import { EcosireClient } from "@ecosire/sdk";

const client = new EcosireClient({ apiKey });

const contacts = await client.contacts.list();

57 Modules

API Modülleri

Kurumsal operasyonların her yönünü kapsayan 57 modülü keşfedin

Çekirdek

AuthUsersContactsProductsOrdersProjectsSettings

Finans

AccountingSalesPurchaseBillingInvoicing

Operasyonlar

InventoryManufacturingPOSRentalPlanning

İnsan Kaynakları

EmployeesRecruitmentTime OffAttendanceExpensesPayrollAppraisals

Pazarlama ve Büyüme

Email MarketingEventsMarketing AutomationAnalyticsAffiliatesLoyalty

Yapay Zeka ve Otomasyon

ECOSIRE AISelf-Evolving EngineContent GenerationSEO Scanner

Security

Kimlik doğrulama

Entegrasyon ihtiyaçlarınıza uyacak iki kimlik doğrulama yöntemi

HttpOnly Çerezler

Tarayıcı uygulamaları için güvenli çerez tabanlı kimlik doğrulama. Jetonlar hiçbir zaman JavaScript'e maruz kalmaz.

Web uygulamasıyla otomatik
HttpOnly, Güvenli, SameSite=Gevşek
7 günlük yenileme jetonu rotasyonu

Taşıyıcı Jetonu

Sunucular arası entegrasyonlar ve API istemcileri için JWT taşıyıcı belirteçlerini kullanın.

// Authorization header

Authorization: Bearer <your_jwt_token>

// Or via HttpOnly cookie

Cookie: ecosire_auth=<token>

Interactive

API Playground

Try any endpoint directly from your browser. Select an endpoint, fill in parameters, and send live requests to the ECOSIRE API.

ECOSIRE API Playground

api.ecosire.com/api

POST/auth/login

Authorization

Request Body (JSON)

https://api.ecosire.com/api/auth/login

Code Snippet

curl -X POST \ \
  "https://api.ecosire.com/api/auth/login" \ \
  -H "Content-Type: application/json" \
  -d '{   "email": "[email protected]",   "password": "secret" }'

SDK

SDK Code Examples

Install the ECOSIRE SDK in your language of choice and explore 6 common operations with full code snippets.

Installation

Choose your language and install the ECOSIRE SDK

npm install @ecosire/sdk

Code Examples

6 common operations with full SDK snippets

1. Authentication

Obtain a JWT token and include it in subsequent requests.

import { EcosireClient } from '@ecosire/sdk';

const client = new EcosireClient({
  baseUrl: 'https://api.ecosire.com/api',
  apiKey: process.env.ECOSIRE_API_KEY,
});

// Login with credentials
const session = await client.auth.login({
  email: '[email protected]',
  password: 'secret',
});

console.log(session.token);   // JWT token
console.log(session.user);    // { id, email, name, role }

// All subsequent calls auto-attach the token
const contacts = await client.contacts.list();

Webhooks

Webhook Events

ECOSIRE sends real-time webhook events to your server when key actions occur — payments, subscriptions, license activations, and more.

Webhook Event Tester

Explore all 8 webhook events, generate cURL commands, and verify HMAC signatures.

Select Webhook Event

Your Webhook URL (optional)

Checkout Completed

checkout.session.completed

Fired when a customer completes payment in a Stripe Checkout Session.

Trigger: Customer pays for a product in the storefront. Auto-grants licenses and creates order.

Example JSON payload delivered to your webhook endpoint for checkout.session.completed.

json

{
  "id": "evt_1ABCxyz",
  "object": "event",
  "type": "checkout.session.completed",
  "created": 1711000000,
  "data": {
    "object": {
      "id": "cs_live_abc123",
      "object": "checkout.session",
      "customer_email": "[email protected]",
      "amount_total": 24900,
      "currency": "usd",
      "mode": "payment",
      "payment_status": "paid",
      "metadata": {
        "userId": "usr_01HXYZ",
        "productIds": "[\"prd_01HODOOCRM\"]"
      }
    }
  }
}

All Webhook Events

Event	Trigger	Fields
`checkout.session.completed` Checkout Completed	Customer pays for a product in the storefront. Auto-grants licenses and creates order.	7 fields
`invoice.paid` Invoice Paid	Monthly/annual subscription renewal is processed. Reactivates suspended licenses and logs billing record.	6 fields
`customer.subscription.deleted` Subscription Cancelled	Subscription period ends and cancel_at_period_end was true, or immediate cancellation was requested. Suspends all associated licenses.	5 fields
`customer.subscription.updated` Subscription Updated	Customer changes their plan, payment fails and subscription pauses, or subscription resumes after payment. Syncs license status accordingly.	5 fields
`charge.refunded` Charge Refunded	Admin or customer initiates a refund via Stripe Dashboard or API. Revokes associated licenses and marks the order as refunded.	5 fields
`payment_intent.payment_failed` Payment Failed	Subscription renewal fails or one-time payment is declined. Marks order as payment_failed and sends failure notification email.	5 fields
`license.validated` License Validated	Odoo module calls POST /licenses/validate on server startup. Used for audit logging and anomaly detection.	5 fields
`license.activated` License Activated	First time POST /licenses/activate is called for a domain. Logs the activation for audit and security monitoring.	5 fields

Verify webhook signatures in production

Always verify the stripe-signature header for Stripe events using your STRIPE_WEBHOOK_SECRET. For license events, verify the X-License-Signature header using ECOSIRE_LICENSE_SECRET. Unverified events should be rejected with 401.

Reference

Error Codes

All API errors follow RFC 7807 (Problem Details for HTTP APIs). Every error includes a machine-readable code and human-readable message.

Status	Meaning	When it occurs
200	OK	Successful GET or POST returning data
201	Created	Successful resource creation (POST)
204	No Content	Successful DELETE or PUT with no body
400	Bad Request	Invalid request body, missing required fields, or malformed JSON
401	Unauthorized	Missing, expired, or invalid JWT token
403	Forbidden	Valid token but insufficient role (e.g. requires admin)
404	Not Found	Resource does not exist or has been deleted
409	Conflict	Duplicate resource — email already registered, license already active
422	Unprocessable	Validation failed — Zod schema rejection with field-level details
429	Too Many Requests	Rate limit exceeded — see Retry-After header
500	Server Error	Unexpected server error — stack trace hidden in production

Error Response Shape

{
  "statusCode": 422,
  "error": "Unprocessable Entity",
  "message": "Validation failed",
  "details": [
    { "field": "email", "message": "Invalid email address" },
    { "field": "password", "message": "Must be at least 8 characters" }
  ]
}

Rate Limits

Hız Limitleri

Tüm kullanıcılar için API istikrarını sağlamak amacıyla adil kullanım sınırları

Uç nokta	Oran Limiti
POST /support	5/min
POST /crm/capture	10/min
POST /ecosire-ai/ask	20/min
POST /licenses/validate	30/min
POST /licenses/activate	10/min
POST /newsletter/subscribe	5/min
Authenticated endpoints	100/min

Rate Limit Response Headers

X-RateLimit-LimitMaximum requests allowed in the window

X-RateLimit-RemainingRequests remaining in the current window

X-RateLimit-ResetUnix timestamp when the window resets

Retry-AfterSeconds to wait before retrying (on 429)

SDK

Kaynaklar ve SDK

Entegrasyonunuzu oluşturmak için ihtiyacınız olan her şey

Etkileşimli API Dokümanları

Swagger UI arayüzümüzle her uç noktayı keşfedin ve test edin. API çağrılarını doğrudan tarayıcınızdan deneyin.

Dokümanlar'ı aç

OpenAPI Spesifikasyonu

OpenAPI 3.0 spesifikasyonunun tamamını JSON formatında indirin. Postman, Insomnia veya kendi araçlarınıza aktarın.

JSON'u indirin

TypeScript SDK'sı

Otomatik tamamlama, hata işleme ve yerleşik yeniden deneme mantığına sahip, tür açısından güvenli API istemcisi.

npm install @ecosire/sdk

API Keys

API Key Management

Create and manage API keys from your dashboard. Each key can be scoped to specific permissions and rotated independently.

Create API Keys

Generate new API keys from Dashboard → Settings → API Keys. Each key has a name, optional expiry date, and role scope.

Scoped Permissions

Keys can be scoped to read-only, read-write, or admin. Admin keys can manage other keys and access all endpoints.

Key Rotation

Rotate keys at any time without downtime. The old key remains valid for 24 hours after rotation for a smooth transition.

Usage Analytics

View per-key request counts, error rates, and last-used timestamps from the API Keys dashboard page.

Environment Keys

Maintain separate keys for development, staging, and production. Production keys log all requests for audit purposes.

Webhook Secrets

Webhook endpoints also use a separate ECOSIRE_LICENSE_SECRET for HMAC-SHA256 signature verification on license events.

Using an API Key

# Pass the key as a Bearer token in the Authorization header
curl https://api.ecosire.com/api/contacts \
  -H "Authorization: Bearer ecos_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# Or use HttpOnly cookies (browser-based auth — set automatically on login)
# Cookie: ecosire_auth=<jwt_token>

FAQ

Sıkça Sorulan Sorular

ECOSIRE API'si hakkında sık sorulan sorular

API erişimini nasıl edinebilirim?

Bir ECOSIRE hesabına kaydolun ve API kimlik bilgilerinizi oluşturmak için Kontrol Paneli > API Anahtarları'na gidin. API erişimi tüm planlarda mevcuttur.

Ücretsiz bir seviye var mı?

Evet, tüm ECOSIRE hesapları API erişimi içerir. Fiyat limitleri plana göre değişir. Ücretsiz katman, günde en fazla 1.000 API çağrısını destekler.

Hangi kimlik doğrulama yöntemleri destekleniyor?

OAuth2'yi Authentik (web uygulamaları için önerilir), JWT taşıyıcı belirteçleri (sunucudan sunucuya) ve API anahtarları (basit entegrasyonlar için) aracılığıyla destekliyoruz.

Web kancası desteğiniz var mı?

Evet, ECOSIRE gerçek zamanlı olay bildirimleri için web kancalarını destekler. Kontrol Paneli > Ayarlar > Web Kancaları'nda web kancası uç noktalarını yapılandırın.

API çalışma süresi SLA'sı nedir?

Tüm API uç noktaları için %99,9 kesintisiz çalışma süresi sağlıyoruz. Durum sayfası ve olay geçmişi status.ecosire.com adresinde mevcuttur.

İnşa etmeye hazır mısınız?

API anahtarınızı alın ve dakikalar içinde entegrasyonlar oluşturmaya başlayın.

API Anahtarını Alın Belgeleri Görüntüle

import { EcosireClient } from '@ecosire/sdk'; const client = new EcosireClient({ baseUrl: 'https://api.ecosire.com/api', apiKey: process.env.ECOSIRE_API_KEY, }); // Login with credentials const session = await client.auth.login({ email: '[email protected]', password: 'secret', }); console.log(session.token); // JWT token console.log(session.user); // { id, email, name, role } // All subsequent calls auto-attach the token const contacts = await client.contacts.list();

{ "id": "evt_1ABCxyz", "object": "event", "type": "checkout.session.completed", "created": 1711000000, "data": { "object": { "id": "cs_live_abc123", "object": "checkout.session", "customer_email": "[email protected]", "amount_total": 24900, "currency": "usd", "mode": "payment", "payment_status": "paid", "metadata": { "userId": "usr_01HXYZ", "productIds": "[\"prd_01HODOOCRM\"]" } } } }

Event

checkout.session.completed

Checkout Completed

invoice.paid

Invoice Paid

customer.subscription.deleted

Subscription Cancelled

customer.subscription.updated

Subscription Updated

charge.refunded

Charge Refunded

payment_intent.payment_failed

Payment Failed

license.validated

License Validated

license.activated

License Activated

Status

Meaning

200

201

Created

204

No Content

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

409

Conflict

422

Unprocessable

429

Too Many Requests

500

Server Error

{ "statusCode": 422, "error": "Unprocessable Entity", "message": "Validation failed", "details": [ { "field": "email", "message": "Invalid email address" }, { "field": "password", "message": "Must be at least 8 characters" } ] }

Uç nokta

Oran Limiti

POST /support

5/min

POST /crm/capture

10/min

POST /ecosire-ai/ask

20/min

POST /licenses/validate

30/min

POST /licenses/activate

10/min

POST /newsletter/subscribe

5/min

Authenticated endpoints

100/min

# Pass the key as a Bearer token in the Authorization header curl https://api.ecosire.com/api/contacts \ -H "Authorization: Bearer ecos_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" # Or use HttpOnly cookies (browser-based auth — set automatically on login) # Cookie: ecosire_auth=<jwt_token>