01Kullanılabilecek teknolojiler
GraphQL
İstemcinin ihtiyaç duyduğu veriyi tek sorguda istemesini sağlayan API sorgu dili.
Webhook
Bir olay olduğunda karşı sisteme anında HTTP bildirimi gönderen yöntem.
REST API
HTTP üzerinden kaynak bazlı çalışan, en yaygın web servis yaklaşımı.
OAuth 2.0 / OIDC
Parola paylaşmadan yetki vermeyi ve tek oturum açmayı (SSO) sağlayan standartlar.
Node.js
JavaScript'i sunucuda çalıştıran ortam; API, gerçek zamanlı uygulama ve entegrasyon servisleri için yaygındır.
02Karşılaştırma tablosu
| Teknoloji | Güçlü yönü | Dikkat edilecek |
|---|---|---|
| GraphQL | esnek veri sorgulama | sorgu maliyeti ve yetki kontrolü dikkat ister |
| Webhook | anlık bildirim | imza doğrulama ve yeniden deneme gerekir |
| REST API | geniş araç desteği | sürümleme ve hata kodları tutarlı tasarlanmalı |
| OAuth 2.0 / OIDC | güvenli yetkilendirme | token süreleri ve kapsamlar doğru ayarlanmalı |
| Node.js | eşzamanlı çok bağlantıyı verimli yönetir | yoğun hesaplama işlerinde ayrı servis gerekebilir |
03API geliştirme planlarken bilinmesi gerekenler
04Tekman'da API geliştirme
Tekman, Erzurum iline bağlı bir ilçedir ve PTT adres verisine göre 71 mahalleden oluşur. Birden fazla ilçede ekibi veya şubesi olan işletmelerde API geliştirme için kullanıcı rolleri, şube bazlı görünürlük ve merkezi raporlar birlikte planlanır.
Mesafe yazılım işinin önünde engel değildir: Tekman'daki ekiplerle görüntülü görüşme, ekran paylaşımı ve test ortamı bağlantısıyla çalışılır; cihaz kurulumu veya saha keşfi gerekirse yerinde ziyaret planlanır.
Aynı ildeki Aşkale, Uzundere ve Köprüköy ilçeleri için de API geliştirme talepleri değerlendirilir; toplantılar uzaktan yapılır.
Tekman 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.
05Barı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.
06Neden "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.
07Ö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
Tekman'dan 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.
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.
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.
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.
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.
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.
API geliştirme için hangi bilgiler hazırlanmalı?
Mevcut sürecin kısa anlatımı, kullanılan dosya ve program örnekleri, kullanıcı sayısı ve REST 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.
→İlgili sayfalar
API Geliştirme hakkında diğer konular
- API geliştirme: hazır paket mi özel yazılım mı?Hazır çözüm ile özel geliştirmenin farkı
- API geliştirme özellikleri ve modülleriOlması gereken modüller ve özellikler
- API geliştirme entegrasyonlarıBağlanabilecek sistemler
- API geliştirme güvenlik ve KVKK uyumuYetki, yedek, log ve KVKK
- API geliştirme KOBİ'ler içinKüçük ve orta işletmeler için yol haritası
Tekman'da ilgili hizmetler
Erzurum içindeki diğer ilçeler
Bu sayfada geçen kavramlar
- REST
- kimlik doğrulama
- dokümantasyon
- CSV
- webhook
- token
- log
- XML
- JSON
- Erzurum
- Tekman