Yardım Merkezi
Takıldığınız her noktada yanınızdayız. Yardım merkezimizde en sık sorulan soruların cevaplarını bulabilir, adım adım rehberlerle sorunlarınızı kolayca çözebilirsiniz.
API (Application Programming Interface), iki yazılım sisteminin birbirleriyle konuşmasını sağlayan arayüzdür. Siz bir uygulamaya istek gönderirsiniz; o uygulama size tanımlı bir formatta yanıt döner. Aradaki iletişim kurallarının tamamı API tarafından belirlenir.
Gerçek Hayattan Bir Analoji
Bir restoranı düşünün: siz müşterisiniz, mutfak ise veriyi işleyen sistem. Garson bu ikisi arasında köprü kurar — siparişinizi alır, mutfağa iletir, hazır yemeği size getirir. API tam olarak bu rolü üstlenir: iki sistem arasında standartlaştırılmış bir mesaj taşıyıcısı.
Temel Kavramlar
Endpoint
Endpoint, API üzerinden erişilebilen belirli bir URL adresidir. Her endpoint bir işleme karşılık gelir.
HTTP Metotları
REST API'lerde her işlem bir HTTP metoduyla tanımlanır:
| Metot | Ne Yapar | Örnek |
| GET | Veri çeker | Kullanıcı bilgilerini getir |
| POST | Yeni kayıt oluşturur | Yeni sipariş oluştur |
| PUT / PATCH | Mevcut kaydı günceller | Kullanıcı adresini güncelle |
| DELETE | Kaydı siler | Sipariş iptal et |
İstek ve Yanıt Yapısı
Bir API isteği genellikle şu bileşenlerden oluşur:
Bir GET isteği örneği:
Sunucudan dönen yanıt örneği:
HTTP Durum Kodları
Sunucu yanıtlarındaki durum kodu, isteğin sonucunu bildirir:
| Kod | Anlamı |
| 200 OK | İstek başarılı |
| 201 Created | Yeni kayıt oluşturuldu |
| 400 Bad Request | Geçersiz istek — hata istemci tarafında |
| 401 Unauthorized | Kimlik doğrulama gerekli veya geçersiz |
| 403 Forbidden | Erişim yetkisi yok |
| 404 Not Found | Kaynak bulunamadı |
| 500 Internal Server Error | Sunucu tarafında hata |
API Türleri
| Tür | Açıklama | Yaygın Kullanım |
| REST | HTTP tabanlı, JSON formatı, en yaygın tür | Web ve mobil uygulamalar |
| SOAP | XML tabanlı, kurumsal sistemlerde kullanılır | Bankacılık, ERP sistemleri |
| GraphQL | İstemci tam olarak istediği veriyi belirtir | Karmaşık veri ihtiyaçları |
| WebSocket | Sürekli açık bağlantı, gerçek zamanlı iletişim | Sohbet, canlı bildirimler |
Kimlik Doğrulama (Authentication)
API'ye gönderilen her istek, çoğunlukla bir kimlik doğrulama yöntemi gerektirir. En yaygın üç yöntem:
Rate Limiting
API sağlayıcıları kötüye kullanımı önlemek için istek sınırı (rate limit) uygular. Sınırı aştığınızda şu yanıtı alırsınız:
API Entegrasyonu Nasıl Yapılır?
Webimonline API Entegrasyon Desteği
Hazır API'leri projenize entegre etmek ya da kendi sisteminiz için özel API geliştirmek istiyorsanız Webimonline Entegrasyon & API Çözümleri sayfasını inceleyebilirsiniz. ERP, CRM ve üçüncü parti servis entegrasyonları için uçtan uca destek sunulmaktadır.
Sık Sorulan Sorular
API ile SDK arasındaki fark nedir? API, iki sistem arasındaki iletişim protokolüdür. SDK (Software Development Kit) ise bu API'yi belirli bir programlama dilinde kullanmayı kolaylaştıran hazır kütüphanedir. Örneğin bir ödeme servisinin hem REST API'si hem de Python ve PHP için SDK'sı olabilir.
REST API ile GraphQL arasında ne zaman hangisini seçmeliyim? Basit ve öngörülebilir veri ihtiyaçlarında REST yeterlidir. Birden fazla kaynaktan veri çekip tek istekte birleştirmeniz gerekiyorsa ya da mobil istemcilerde bant genişliği kritikse GraphQL daha verimli olur.
API anahtarımı kodun içine yazmak güvenli midir? Hayır. API anahtarları her zaman ortam değişkenlerinde (.env dosyası veya sunucu environment variables) saklanmalıdır. Kaynak kod deposuna (GitHub vb.) asla doğrudan eklemeyin.