01Kullanılabilecek teknolojiler
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.
PostgreSQL
Açık kaynaklı, güçlü ilişkisel veritabanı; karmaşık sorgular, JSON verisi ve büyük tablolar için uygundur.
OAuth 2.0 / OIDC
Parola paylaşmadan yetki vermeyi ve tek oturum açmayı (SSO) sağlayan standartlar.
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 |
|---|---|---|
| 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 |
| PostgreSQL | veri bütünlüğü ve gelişmiş sorgular | indeks ve bakım (vacuum) planı yapılmalı |
| OAuth 2.0 / OIDC | güvenli yetkilendirme | token süreleri ve kapsamlar doğru ayarlanmalı |
| Webhook | anlık bildirim | imza doğrulama ve yeniden deneme gerekir |
03Özel API servisi planlarken bilinmesi gerekenler
- hata kodu standardı.
- OpenAPI dokümantasyonu
- kimlik doğrulama (API anahtarı, OAuth 2.0)
04Amasya Merkez'de özel API servisi
PTT kayıtlarında Amasya Merkez ilçesine bağlı 202 yerleşim bulunur: 40 mahalle ile 162 köy ve köy yerleşimi. Bu kayıtlardan 1 tanesi organize sanayi veya serbest bölge kaydıdır.
Yazılım projelerinde analiz, tasarım ve geliştirme çoğunlukla uzaktan, görüntülü toplantılarla yürür; Amasya Merkez'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.
Aynı ildeki Hamamözü, Gümüşhacıköy ve Suluova ilçeleri için de özel API servisi talepleri değerlendirilir; toplantılar uzaktan yapılır.
Mevcut Excel dosyanızı veya ekran görüntülerinizi WhatsApp'tan gönderin; özel API servisi için hangi modüllerle başlanabileceğini konuşalım. Telefon: 0540 003 19 81.
05Özel API servisi hangi ihtiyaca cevap verir?
Oturum açma her üründe ayrı yönetildiğinde
Merkezi kimlik doğrulama ve SSO ile kullanıcı yönetimi sadeleşir.
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.
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
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.
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.
Ö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.
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.
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 Amasya için mi çalışıyorsunuz?
Askadar Yazılım 81 ilde uzaktan çalışır; Amasya de bunlardan biridir. Yerinde iş gerektiğinde ziyaret planlanı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.
→İlgili sayfalar
Özel API Servisi hakkında diğer konular
- Özel API servisi: hazır paket mi özel yazılım mı?Hazır çözüm ile özel geliştirmenin farkı
- Özel API servisi geliştirme süreciAnalizden yayına aşamalar
- Özel API servisi firmasıFirma seçerken bakılacaklar
- Özel API servisi bakım ve destekYayın sonrası bakım, güncelleme ve destek
- Özel API servisi güvenlik ve KVKK uyumuYetki, yedek, log ve KVKK
Amasya Merkez'de ilgili hizmetler
Amasya içindeki diğer ilçeler
Bu sayfada geçen kavramlar
- sürümleme
- kota
- izleme
- SSO
- rate limit
- OpenAPI
- API anahtarı
- webhook
- Swagger
- Amasya
- Merkez