Çözümler Sektörler Referanslar Bilgi Merkezi Hakkımızda İletişim Teklif Al
Eğitim Özeti: Okuma Süresi: ~9 dakika | Seviye: Başlangıç-Orta Düzey | Konu: RESTful API Mimarisi, Webhook'lar, JSON Veri Yapısı, OAuth2 & JWT Güvenliği, ERP/CRM Entegrasyonları

Modern bir işletmede onlarca farklı yazılım bir arada kullanılır: Muhasebe ve ERP programı (Logo, Mikro, SAP), e-ticaret sitesi, mağaza POS cihazları, müşteri ilişkileri yazılımı (CRM), banka posları ve kargo sistemleri. Eğer bu programlar birbirine bağlı değilse, çalışanlar siparişleri bir ekrandan okuyup diğer ekrana elle girmek zorunda kalır. Bu durum devasa bir zaman kaybına ve ölümcül fatura/stok hatalarına yol açar.

API (Application Programming Interface - Uygulama Programlama Arayüzü); iki farklı yazılımın insan müdahalesine gerek kalmadan, güvenli ve standart kurallar çerçevesinde birbiriyle veri alışverişi yapmasını ve komut yürütmesini sağlayan dijital iletişim protokolüdür.

1. API Nasıl Çalışır? Restoran Analojisi

API'yi anlamanın en klasik yolu lüks bir restoran örneğidir:

  • Siz (İstemci - Client / Ön Yüz): Masada oturan müşterisiniz. Mutfağa doğrudan girip yemek pişiremezsiniz. Menüden siparişinizi seçersiniz.
  • Garson (API): Siparişinizi alır, mutfağa (sunucuya/veritabanına) standart bir dille iletir. Yemek hazır olduğunda mutfaktan tabağı alıp size teslim eder.
  • Mutfak (Sunucu - Server / Veritabanı): Yemeğin hazırlandığı, stokların ve verilerin tutulduğu arka sistemdir. API aracılığıyla sadece izin verilen işlemler yürütülür.

2. Modern API Mimarileri: REST vs SOAP vs Webhook

Teknoloji Protokol & Veri Formatı Çalışma Modeli En Sık Kullanıldığı Alan
RESTful API HTTP / HTTPS, hafif JSON formatı İstek-Yanıt (Request - Response). İstemci sorar, sunucu döner. Durumsuz (Stateless). Web ve mobil uygulamalar, modern SaaS servisleri, ERP entegrasyonları.
SOAP HTTP / SMTP, katı XML sözdizimi WSDL şemalı, yüksek standartlı güvenlik (WS-Security), ağır paket yapısı. Bankacılık sistemleri, devlet kurumları (GİB E-Fatura, KPS, MERNIS).
Webhook (Ters API) HTTP POST, JSON yükü Olay Tabanlı (Event-Driven): İstemcinin sürekli sormasına gerek kalmaz; olay olduğunda sunucu anında bildirir. Ödeme onayları (Iyzico, Stripe), kargo teslim bildirimleri, WhatsApp anlık mesajları.

3. REST API'nin Standart HTTP Metodları ve Durum Kodları

REST mimarisinde verilerle etkileşim kurmak için standart HTTP fiilleri (Verbs) kullanılır:

  • GET /api/urunler/105 ➔ 105 ID'li ürünün bilgilerini getirir (Okuma).
  • POST /api/siparisler ➔ Yeni bir sipariş oluşturur (Yazma / Ekleme).
  • PUT /api/urunler/105 ➔ Ürünün tüm bilgilerini baştan aşağı günceller.
  • PATCH /api/urunler/105 ➔ Ürünün sadece fiyatını veya stok adedini kısmi günceller.
  • DELETE /api/musteriler/42 ➔ İlgili kaydı siler.

Kritik HTTP Durum Kodları (Status Codes)

  • 200 OK: İstek başarılı ve yanıt gövdesi döndü.
  • 201 Created: Yeni kayıt (örn. fatura veya kullanıcı) başarıyla oluşturuldu.
  • 400 Bad Request: İstemci hatalı veya eksik JSON verisi gönderdi.
  • 401 Unauthorized: API Token veya şifre geçersiz, kimlik doğrulanamadı.
  • 403 Forbidden: Kimlik geçerli ancak bu veriyi okuma/yazma yetkisi yok.
  • 429 Too Many Requests: Dakikalık istek sınırı (Rate-Limit) aşıldı.
  • 500 Internal Server Error: Karşı sunucunun kodunda beklenmeyen bir çökme meydana geldi.

4. Kurumsal İş Süreçlerinde Gerçek API Entegrasyon Senaryoları

Safanet DENS olarak işletmelerin iş yükünü %90 azaltan entegrasyon projelerimiz:

Sektörel Senaryo Entegre Olan Sistemler Otomatikleşen İş Süreci
Pazaryeri & ERP Senkronu Trendyol / Hepsiburada ➔ Logo ERP Pazaryerinde ürün satıldığında fatura ERP'de otomatik kesilir; ERP'deki güncel stok pazaryerine anlık basılır.
Otel Rezervasyon & GİB Otel PMS (Elektra/Sedna) ➔ E-Fatura API Misafir check-out yaptığı anda konaklama vergisi hesaplanarak Gelir İdaresi Başkanlığı onaylı e-arşiv fatura otomatik üretilir.
Web Form & Saha İletişim Kurumsal Web Sitesi ➔ CRM + WhatsApp API Webden teklif formu doldurulduğunda müşteri temsilcisinin telefonuna WhatsApp bildirimi düşer ve CRM'de fırsat açılır.
Saha IoT & Enerji İzleme Elektrik / Su Analizörleri ➔ Bulut Dashboard Fabrikadaki enerji tüketim sayaçları her 5 saniyede bir REST API ile tüketim verilerini sunucuya iletir, anomali anında alarm verir.

5. API Geliştirme ve Entegrasyonunda En Sık Yapılan 5 Hata

  1. API Gizli Anahtarlarını (Secret Keys) Kodun İçine Gömmek: Frontend JavaScript kodunun içinde açık yazılan API anahtarları tarayıcıdan saniyeler içinde çalınabilir. Anahtarlar sunucu tarafında (Environment Variable) saklanmalıdır.
  2. İdempotency (Tekilleştirme) Mekanizması Kurmamak: Zayıf internette sipariş butonu iki kez basılırsa veya API bağlantısı kopup tekrar denerse aynı kredi kartından iki kez para çekilebilir. POST isteklerinde Idempotency-Key başlığı kullanılmalıdır.
  3. Rate Limiting (İstek Sınırlama) Uygulamamak: Açık bir API uç noktasına botlar saniyede 5000 istek göndererek sunucuyu çökertebilir veya veri tabanını tarayabilir. Token Bucket algoritmasıyla IP başına sınır konmalıdır.
  4. Sürüm Yönetimi (Versioning) Yapmamak: API'de bir alanı değiştirdiğinizde eski mobil uygulamalar çöker. Endpoint'ler mutlaka /api/v1/, /api/v2/ şeklinde sürümlenmelidir.
  5. Webhook İmzalarını (HMAC-SHA256) Doğrulamamak: Ödeme servisinden geldiği iddia edilen bir webhook sahte olabilir. Gelen verinin hash imzası doğrulanmadan sipariş "ödendi" olarak onaylanmamalıdır.

İş Süreçlerinizi API ve Otomasyonla Hızlandırın

Safanet DENS Bilgi Teknolojileri olarak e-ticaret, ERP, CRM, ödeme geçitleri ve IoT cihazlarınız arasında yüksek hızlı, güvenli ve kesintisiz API entegrasyonları geliştiriyoruz.

Entegrasyon Projenizi Anlatın Yazılım Ekibimizle Görüşün