01Kullanılabilecek teknolojiler
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.
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.
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 |
|---|---|---|
| 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 |
| 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 |
| 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
- 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ü.
- Hata durumunda yeniden deneme, kuyruk ve bildirim kurgulanır.
04İlkadım'da API geliştirme
İlkadım, Samsun iline bağlı bir ilçedir ve PTT adres verisine göre 62 mahalleden oluşur. Bu kayıtlardan 1 tanesi organize sanayi veya serbest bölge kaydıdır. 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.
İlkadım'da 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.
Samsun genelinde Terme, 19 Mayıs ve Havza gibi diğer ilçelerdeki işletmelerle de aynı uzaktan çalışma düzeniyle ilerlenir.
İlkadım 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?
Dokümantasyon gerektiğinde
Dokümantasyon, API geliştirme projesinde kapsamın başında konuşulan başlıklardandır; analizde kimin kullanacağı ve nasıl çalışacağı netleştirilir.
Sistemler birbirinden habersiz çalıştığında
Stok, cari, sipariş ve fatura gibi kayıtlar ortak kurallarla eşitlenir; herkes aynı veriyi görü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
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.
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.
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.
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.
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.
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.
Samsun dışındaki işletmelere de hizmet veriyor musunuz?
Evet. Askadar Yazılım, Türkiye'nin 81 ilindeki işletmelerle uzaktan çalışır; gerektiğinde yerinde çalışma 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.
→İlgili sayfalar
API Geliştirme hakkında diğer konular
- API geliştirme geçiş ve veri aktarımıExcel'den veya eski sistemden geçiş
- API geliştirme firmasıFirma seçerken bakılacaklar
- API geliştirme yaptırmaKapsam, süreç ve iletişim
- API geliştirme bakım ve destekYayın sonrası bakım, güncelleme ve destek
- API geliştirme KOBİ'ler içinKüçük ve orta işletmeler için yol haritası
İlkadım'da ilgili hizmetler
Samsun içindeki diğer ilçeler
Bu sayfada geçen kavramlar
- REST
- kimlik doğrulama
- dokümantasyon
- CSV
- webhook
- token
- senkronizasyon
- XML
- JSON
- Samsun
- İlkadım