01Kullanılabilecek teknolojiler
.NET
Microsoft'un kurumsal uygulama platformu; masaüstü, web ve servis geliştirmede kullanılır.
OAuth 2.0 / OIDC
Parola paylaşmadan yetki vermeyi ve tek oturum açmayı (SSO) sağlayan standartlar.
GraphQL
İstemcinin ihtiyaç duyduğu veriyi tek sorguda istemesini sağlayan API sorgu dili.
REST API
HTTP üzerinden kaynak bazlı çalışan, en yaygın web servis yaklaşımı.
Webhook
Bir olay olduğunda karşı sisteme anında HTTP bildirimi gönderen yöntem.
02Karşılaştırma tablosu
| Teknoloji | Güçlü yönü | Dikkat edilecek |
|---|---|---|
| .NET | kurumsal sistemlerle uyum | lisans ve barındırma tercihleri baştan netleşmeli |
| OAuth 2.0 / OIDC | güvenli yetkilendirme | token süreleri ve kapsamlar doğru ayarlanmalı |
| GraphQL | esnek veri sorgulama | sorgu maliyeti ve yetki kontrolü dikkat ister |
| REST API | geniş araç desteği | sürümleme ve hata kodları tutarlı tasarlanmalı |
| Webhook | anlık bildirim | imza doğrulama ve yeniden deneme gerekir |
03API geliştirme planlarken bilinmesi gerekenler
- Hata durumunda yeniden deneme, kuyruk ve bildirim kurgulanır.
- Lisanslı ürünlerde (Logo, Mikro, Netsis, Nebim, SAP) entegrasyon, ürünün resmî entegrasyon araçları ve lisans koşullarıyla yapılır.
- Bağlantı yöntemi, sistemin sunduğu imkâna göre seçilir: REST/SOAP API, webhook, dosya (CSV/XML), veritabanı görünümü.
04Körfez için çalışma düzeni
Körfez, Kocaeli iline bağlı bir ilçedir ve PTT adres verisine göre 36 mahalleden oluşur. Büyükşehirlerde merkez ve şube yapısıyla çalışan işletmeler için API geliştirme tasarımında merkez-şube yetki yapısı ve birleşik raporlama öne çıkar.
Yazılım projelerinde analiz, tasarım ve geliştirme çoğunlukla uzaktan, görüntülü toplantılarla yürür; Körfez'deki işletmelerle ekran paylaşımlı demolar ve ortak bir proje panosu üzerinden çalışılır. Donanım kurulumu, saha keşfi veya kullanıcı eğitimi gereken işlerde yerinde çalışma planlanır.
Kocaeli genelinde Derince, Kandıra ve Gebze gibi diğer ilçelerdeki işletmelerle de aynı uzaktan çalışma düzeniyle ilerlenir.
Körfez bölgesinden API geliştirme için ilk görüşmeyi telefonla yapabiliriz: 0540 003 19 81. İsterseniz kısa bir not bırakın, biz arayalım.
05API geliştirme hangi ihtiyaca cevap verir?
Sistemler birbirinden habersiz çalıştığında
Stok, cari, sipariş ve fatura gibi kayıtlar ortak kurallarla eşitlenir; herkes aynı veriyi görür.
Yeni bir yazılım devreye alınırken
Mevcut sistemler değiştirilmeden yeni yazılımla bağlantı kurulur; geçiş kademeli yapılır.
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
Uygulamayı bağımlılıklarıyla birlikte konteynere paketleyen araç; her ortamda aynı şekilde çalışmasını sağlar.
07Neden "en yeni" değil "doğru" teknoloji?
Doğru teknoloji; ihtiyacı karşılayan, yeni bir geliştiricinin kolayca devralabileceği ve güncellemeleri düzenli çıkan teknolojidir.
08Ölçeklenebilirlik
Ölçek ihtiyacı tahminle değil ölçümle belirlenir; izleme kurulur, darboğaz görüldüğünde ilgili katman güçlendirilir.
SSSSık sorulan sorular
API geliştirme sonradan genişletilebilir mi?
Evet. Kimlik doğrulama gibi özellikler ilk sürümde olmasa da modüler yapı sayesinde sürüm planıyla eklenebilir.
Logo veya Mikro entegrasyonu için lisans gerekir mi?
Entegrasyon ürünün resmî araçları ve lisans koşullarıyla yapılır; bazı bağlantı yöntemleri ek modül veya kullanıcı lisansı gerektirebilir. Bunu analizde ürün sağlayıcınızın güncel koşullarıyla birlikte netleştiririz.
Açık kaynak teknoloji güvenli mi?
Yaygın ve düzenli güncellenen açık kaynak teknolojiler, doğru yapılandırma ve güncelleme disipliniyle güvenle kullanılı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.
Sadece Kocaeli 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.
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.
Körfez'den yazıyorum; toplantılar nasıl yapılıyor?
Toplantılar görüntülü yapılır ve ekran paylaşımıyla ilerler. Cihaz kurulumu, saha incelemesi veya ekip eğitimi gibi yerinde bulunmayı gerektiren adımlar ayrıca planlanır.
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
API Geliştirme hakkında diğer konular
- API geliştirme bakım ve destekYayın sonrası bakım, güncelleme ve destek
- API geliştirme firmasıFirma seçerken bakılacaklar
- API geliştirme yaptırmaKapsam, süreç ve iletişim
- API geliştirme özellikleri ve modülleriOlması gereken modüller ve özellikler
- API geliştirme geçiş ve veri aktarımıExcel'den veya eski sistemden geçiş
Körfez'de ilgili hizmetler
Kocaeli içindeki diğer ilçeler
Bu sayfada geçen kavramlar
- REST
- kimlik doğrulama
- dokümantasyon
- CSV
- webhook
- token
- log
- middleware
- senkronizasyon
- Kocaeli
- Körfez