SDK'lar & Kütüphaneler

TotalApp'i tercih ettiğiniz programlama dili ile entegre edin. JavaScript, Python, Go ve PHP için resmi SDK'lar ile dakikalar içinde başlayın.

Mevcut SDK'lar

TotalApp, en popüler programlama dilleri için resmi SDK'lar sunar. Tüm SDK'lar açık kaynaklıdır ve aktif olarak bakımı yapılmaktadır.

JS / TS JavaScript / TypeScript

Node.js ve tarayıcı ortamları için. TypeScript tanımları dahildir. npm install @totalapp/sdk

Python Python

Python 3.8+ desteği. Async/await ile tam uyumlu. pip install totalapp-sdk

Go Go

Go 1.18+ ile goroutine dostu tasarım. go get github.com/totalapp/sdk-go

PHP PHP

PHP 8.0+ desteği, Composer ile kurulum. composer require totalapp/sdk

Hızlı Başlangıç — JavaScript

1. SDK Kur

→

2. İstemci Oluştur

→

3. API'yi Çağır

→

4. Veriyi İşle

npm install @totalapp/sdk

import { TotalApp } from '@totalapp/sdk';

const client = new TotalApp({
  apiKey: process.env.TOTALAPP_API_KEY,
  baseUrl: 'https://app.totalapp.app',
});

// Personeli listele
const employees = await client.employees.list({ limit: 50 });

// Yeni proje oluştur
const project = await client.projects.create({
  name: 'Q4 Lansmanı',
  description: 'Ürün lansmanı proje yönetimi',
});

Hızlı Başlangıç — Python

pip install totalapp-sdk

import asyncio
from totalapp import TotalApp

client = TotalApp(api_key="YOUR_API_KEY")

async def main():
    # Faturaları listele
    invoices = await client.invoices.list(limit=100)

    # Harcama oluştur
    expense = await client.expenses.create(
        amount=1500.00,
        currency="TRY",
        description="Yazılım lisansı",
        category="software"
    )

asyncio.run(main())

SDK Özellikleri

Özellik	JS/TS	Python	Go	PHP
Otomatik yeniden deneme	✓	✓	✓	✓
Hız sınırı yönetimi	✓	✓	✓	Yakında
Webhook imza doğrulama	✓	✓	✓	✓
Sayfalama yardımcıları	✓	✓	✓	✓
TypeScript tanımları	✓	Stub'lar	—	—
Async/await	✓	✓	Goroutine	✓

Sık Sorulan Sorular

SDK'yı REST API yerine ne zaman kullanmalıyım?

SDK'lar otomatik yeniden deneme, hız sınırı yönetimi ve tip güvenliği sağlar. Yeni bir uygulama geliştiriyorsanız SDK kullanımı önerilir. Ham REST, SDK'nın desteklemediği diller veya özel gereksinimler için uygundur.

SDK versiyonları API versiyonlarıyla nasıl eşleşir?

SDK major versiyonu API major versiyonuna karşılık gelir. @totalapp/sdk@1.x → API v1. Bir major versiyon gerisindeki SDK'lar en az 12 ay boyunca desteklenmeye devam eder.

Topluluk tarafından oluşturulmuş SDK'lar var mı?

Evet. Ruby, Rust ve .NET için topluluk SDK'ları GitHub'da mevcuttur. Bunlar resmi olarak desteklenmez ancak API belgelerimizi takip ederler. Katkıda bulunmak için Üçüncü Taraf Entegrasyonlar sayfasına bakın.