Orbit REST API

Orbit'in güçlü API'leri ile muhasebe verilerinize programatik erişim sağlayın. RESTful mimaride tasarlanmış API'lerimiz ile sistemlerinizi entegre edin.

50+
Endpoint
JSON
Data Format
OAuth 2.0
Authentication

Stok API

8 Endpoints

Stok verilerinizi yönetmek için gerekli tüm API'ler

GET /api/stok Stok listesi
POST /api/stok Yeni stok ekleme
PUT /api/stok/{id} Stok güncelleme
DELETE /api/stok/{id} Stok silme

Cari API

10 Endpoints

Müşteri ve satıcı hesaplarını API ile yönetin

GET /api/cari Cari listesi
POST /api/cari Yeni cari ekleme
GET /api/cari/{id}/bakiye Cari bakiye sorgulama
GET /api/cari/{id}/hareket Cari hesap hareketleri

Fatura API

12 Endpoints

Fatura oluşturma ve yönetim işlemleri

POST /api/fatura Fatura oluşturma
GET /api/fatura/{id} Fatura detayı
POST /api/fatura/{id}/efatura E-fatura gönderme
GET /api/fatura/{id}/pdf Fatura PDF'i

Rapor API

6 Endpoints

Detaylı raporlar ve analizler için API'ler

GET /api/rapor/cari-bakiye Cari bakiye raporu
GET /api/rapor/stok-hareket Stok hareket raporu
GET /api/rapor/gelir-gider Gelir-gider raporu
GET /api/rapor/kasa-hareket Kasa hareket raporu

Authentication

OAuth 2.0 Authorization

Orbit API'leri OAuth 2.0 standartını kullanır. API erişimi için öncelikle access token almanız gerekir.

Token İsteği
POST /oauth/token
Content-Type: application/json

{
  "grant_type": "client_credentials",
  "client_id": "your_client_id",
  "client_secret": "your_client_secret",
  "scope": "api:read api:write"
}
API İsteklerinde Token Kullanımı

Aldığınız access token'ı her API isteğinde Authorization header'ında Bearer token olarak gönderin.

Örnek İstek
GET /api/stok
Authorization: Bearer {access_token}
Content-Type: application/json
Not: Access token'ların 24 saat geçerlilik süresi vardır.

Örnek Kullanım

Stok Ekleme (JavaScript)
const response = await fetch('/api/stok', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer ' + accessToken
  },
  body: JSON.stringify({
    "stokKodu": "STK001",
    "stokAdi": "Örnek Ürün",
    "birim": "Adet",
    "alisFiyati": 100.00,
    "satisFiyati": 150.00,
    "stokMiktari": 50
  })
});

const result = await response.json();
console.log(result);
Cari Bakiye Sorgulama (C#)
using (var client = new HttpClient())
{
    client.DefaultRequestHeaders.Authorization = 
        new AuthenticationHeaderValue("Bearer", accessToken);
    
    var response = await client.GetAsync(
        "/api/cari/123/bakiye");
    
    if (response.IsSuccessStatusCode)
    {
        var content = await response.Content
            .ReadAsStringAsync();
        var bakiye = JsonSerializer
            .Deserialize<CariBakiye>(content);
    }
}

Hata Yönetimi

API'ler standart HTTP status kodları kullanır ve hata durumlarında JSON formatında detaylı bilgi döner.

HTTP Status Kodları
200 OK - İşlem başarılı
201 Created - Kayıt oluşturuldu
400 Bad Request - Geçersiz istek
401 Unauthorized - Yetki yok
404 Not Found - Kayıt bulunamadı
500 Server Error - Sunucu hatası
Örnek Hata Yanıtı
{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Geçersiz veri",
    "details": [
      {
        "field": "stokKodu",
        "message": "Stok kodu zorunludur"
      },
      {
        "field": "alisFiyati",
        "message": "Alış fiyatı 0'dan büyük olmalıdır"
      }
    ]
  }
}

SDK ve Araçlar

JavaScript SDK

Node.js ve Browser için resmi SDK

İndir
C# .NET SDK

.NET Core ve Framework için SDK

İndir
Python SDK

Python 3.x için resmi SDK

İndir
Postman Collection

API test koleksiyonu

İndir

Rate Limiting

API kullanımında adil kullanım politikası uygulanır:

  • Genel API İstekleri 1000/saat
  • Rapor API'leri 100/saat
  • E-belge API'leri 500/saat

API Desteği

API geliştirme sürecinizde size yardımcı olmak için:

Canlı destek: 7/24 chat desteği
GitHub: Örnek projeler ve kod örnekleri

API Erişimi İçin Başvurun

Orbit API'lerini kullanmaya başlamak için API key'inizi alın ve entegrasyonunuzu geliştirin.

An unhandled error has occurred. Reload 🗙