01Kullanılabilecek teknolojiler
REST API
HTTP üzerinden kaynak bazlı çalışan, en yaygın web servis yaklaşımı.
GraphQL
İstemcinin ihtiyaç duyduğu veriyi tek sorguda istemesini sağlayan API sorgu dili.
Node.js
JavaScript'i sunucuda çalıştıran ortam; API, gerçek zamanlı uygulama ve entegrasyon servisleri için yaygındır.
Webhook
Bir olay olduğunda karşı sisteme anında HTTP bildirimi gönderen yöntem.
OAuth 2.0 / OIDC
Parola paylaşmadan yetki vermeyi ve tek oturum açmayı (SSO) sağlayan standartlar.
02Karşılaştırma tablosu
| Teknoloji | Güçlü yönü | Dikkat edilecek |
|---|---|---|
| REST API | geniş araç desteği | sürümleme ve hata kodları tutarlı tasarlanmalı |
| GraphQL | esnek veri sorgulama | sorgu maliyeti ve yetki kontrolü dikkat ister |
| Node.js | eşzamanlı çok bağlantıyı verimli yönetir | yoğun hesaplama işlerinde ayrı servis gerekebilir |
| Webhook | anlık bildirim | imza doğrulama ve yeniden deneme gerekir |
| OAuth 2.0 / OIDC | güvenli yetkilendirme | token süreleri ve kapsamlar doğru ayarlanmalı |
03Özel API servisi planlarken bilinmesi gerekenler
- OpenAPI dokümantasyonu
- kimlik doğrulama (API anahtarı, OAuth 2.0)
- hata kodu standardı.
04Sancaktepe'de özel API servisi
Sancaktepe, İstanbul iline bağlı bir ilçedir ve PTT adres verisine göre 19 mahalleden oluşur. Büyükşehirlerde merkez ve şube yapısıyla çalışan işletmeler için özel API servisi tasarımında merkez-şube yetki yapısı ve birleşik raporlama öne çıkar.
Sancaktepe'de bulunan bir işletmeyle çalışırken toplantılar görüntülü yapılır, her aşama test ortamında paylaşılır ve geri bildirimler ortak panoda toplanır; yerinde bulunmak gereken kurulum ve eğitim adımları ayrıca planlanır.
Aynı ildeki Güngören, Eyüpsultan ve Ataşehir ilçeleri için de özel API servisi talepleri değerlendirilir; toplantılar uzaktan yapılır.
Özel API servisini planlıyorsanız 0540 003 19 81 numarasını arayın veya WhatsApp'tan ihtiyacınızı birkaç cümleyle yazın; teklif formunu da doldurabilirsiniz.
05Özel API servisi hangi ihtiyaca cevap verir?
Sürümleme gerektiğinde
Sürümleme, özel API servisi projesinde kapsamın başında konuşulan başlıklardandır; analizde kimin kullanacağı ve nasıl çalışacağı netleştirilir.
Verinizi iş ortaklarına açmak istediğinizde
Özel API servisi ile veri, yetki ve kota kontrolüyle güvenli biçimde dış sistemlere sunulur.
06Barındırma seçenekleri
- Bulut sunucu (VPS): esnek, kaynak ihtiyacına göre büyütülebilir
- Yönetilen platformlar: altyapı yönetimini sağlayıcıya bırakır
- Şirket içi sunucu: verinin kurum içinde kalması gerektiğinde
- Konteyner tabanlı yayın (Docker): her ortamda aynı kurulum
DNS, CDN, önbellek, SSL ve güvenlik katmanı sunan altyapı hizmeti.
07Neden "en yeni" değil "doğru" teknoloji?
Teknoloji seçimi uzun vadeli bakım maliyetini belirler. Yaygın, belgelenmiş ve ekibin bildiği bir teknoloji; en yeni ama az bilinen bir teknolojiden çoğu zaman daha doğru bir tercihtir.
08Ölçeklenebilirlik
Özel API servisi büyüdükçe veritabanı indeksleri, önbellek ve arka plan kuyrukları devreye girer; mimari bu adımlara baştan izin verecek şekilde kurulur.
SSSSık sorulan sorular
Sadece İstanbul için mi çalışıyorsunuz?
Hayır, Türkiye'nin her ilindeki işletmelerle çalışıyoruz; Marmara Bölgesi dahil tüm bölgelerde süreç aynı düzenle yürür.
Özel API servisi sonradan genişletilebilir mi?
Evet. Kota gibi özellikler ilk sürümde olmasa da modüler yapı sayesinde sürüm planıyla eklenebilir.
REST mi GraphQL mi?
Kaynak bazlı, önbelleğe uygun ve geniş araç desteği gereken çoğu iş API'sinde REST yeterlidir. İstemcilerin çok farklı veri kombinasyonları istediği ürünlerde GraphQL değerlendirilir.
Özel API servisi için hangi bilgiler hazırlanmalı?
Mevcut sürecin kısa anlatımı, kullanılan dosya ve program örnekleri, kullanıcı sayısı ve sürümleme gibi beklentiler ilk görüşme için yeterlidir; kapsam analizde netleşir.
Kullanılan teknoloji ileride sorun olur mu?
Yaygın ve düzenli güncellenen teknolojiler seçildiğinde başka bir ekip de projeyi devralabilir; dokümantasyon bu riski ayrıca azaltır.
Teknolojiyi biz mi seçmeliyiz?
İhtiyacınızı ve tercihlerinizi (barındırma, mevcut ekip, bütçe) paylaşmanız yeterli; seçenekleri artı ve eksileriyle sunar, kararı birlikte veririz.
Sancaktepe'den yazıyorum; toplantılar nasıl yapılıyor?
İşin büyük bölümü uzaktan yürür: ilk görüşme telefonla, sonraki toplantılar görüntülü yapılır. Kurulum ya da eğitim gerekiyorsa yerinde çalışma takvime eklenir.
Bulut mu şirket içi sunucu mu?
Esneklik ve kolay yönetim için bulut; verinin kurum içinde kalması gerektiğinde şirket içi sunucu tercih edilir. Hibrit yapı da mümkündür.
→İlgili sayfalar
Özel API Servisi hakkında diğer konular
- Özel API servisi firmasıFirma seçerken bakılacaklar
- Özel API servisi yaptırmaKapsam, süreç ve iletişim
- Özel API servisi entegrasyonlarıBağlanabilecek sistemler
- Özel API servisi fiyatlarıMaliyeti belirleyen kalemler ve teklif karşılaştırma
- Özel API servisi özellikleri ve modülleriOlması gereken modüller ve özellikler
Sancaktepe'de ilgili hizmetler
İstanbul içindeki diğer ilçeler
Bu sayfada geçen kavramlar
- sürümleme
- kota
- izleme
- SSO
- rate limit
- OpenAPI
- API anahtarı
- geliştirici portalı
- webhook
- İstanbul
- Sancaktepe