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.
Stok API
8 EndpointsStok verilerinizi yönetmek için gerekli tüm API'ler
/api/stok
Stok listesi/api/stok
Yeni stok ekleme/api/stok/{id}
Stok güncelleme/api/stok/{id}
Stok silmeCari API
10 EndpointsMüşteri ve satıcı hesaplarını API ile yönetin
/api/cari
Cari listesi/api/cari
Yeni cari ekleme/api/cari/{id}/bakiye
Cari bakiye sorgulama/api/cari/{id}/hareket
Cari hesap hareketleriFatura API
12 EndpointsFatura oluşturma ve yönetim işlemleri
/api/fatura
Fatura oluşturma/api/fatura/{id}
Fatura detayı/api/fatura/{id}/efatura
E-fatura gönderme/api/fatura/{id}/pdf
Fatura PDF'iRapor API
6 EndpointsDetaylı raporlar ve analizler için API'ler
/api/rapor/cari-bakiye
Cari bakiye raporu/api/rapor/stok-hareket
Stok hareket raporu/api/rapor/gelir-gider
Gelir-gider raporu/api/rapor/kasa-hareket
Kasa hareket raporuAuthentication
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
Ö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şturuldu400
Bad Request - Geçersiz istek401
Unauthorized - Yetki yok404
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"
}
]
}
}
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:
API Erişimi İçin Başvurun
Orbit API'lerini kullanmaya başlamak için API key'inizi alın ve entegrasyonunuzu geliştirin.