Teknoloji11 Mayıs 20267 dk okuma

Sistem Entegrasyonu: ISO/IEC 25010 ve API Stratejisi

Operasyon platformlarının birbiriyle konuşması ISO/IEC 25010 'interoperability' kalite özelliğidir. REST, GraphQL, Webhook ve iPaaS kararları.

ISO/IEC 25010: yazılım kalitesi 8 boyut

ISO/IEC 25010:2011 'Systems and software Quality Requirements and Evaluation' (SQuaRE) 8 kalite özelliği tanımlar: Functional Suitability, Performance Efficiency, Compatibility, Usability, Reliability, Security, Maintainability, Portability. 'Compatibility' alt-boyutu 'Interoperability' (birlikte çalışabilirlik) sistem entegrasyonunun standart referansıdır. Yazılım seçiminde bu 8 boyut checklist olarak kullanılır.

API stratejileri: REST vs GraphQL vs gRPC

REST (Representational State Transfer): HTTP üzerinde resource-based — basit, cacheable, geniş kabul. OpenAPI 3.1 standart spesifikasyonu. GraphQL (Meta 2015): client-driven sorgular — over/under-fetching çözer ama caching zor. gRPC (Google): HTTP/2 + Protobuf, performanslı ama tarayıcıdan zor. KontrolJet ekosistem API'leri OpenAPI 3.1 standardında — modern bordro/ERP/CRM ile uyumlu.

Webhook vs Polling

Webhook: olay olduğunda hedef sistem URL'sine POST. Polling: hedef sistem periyodik 'değişti mi?' sorgusu. CNCF (Cloud Native Computing Foundation) 'CloudEvents' standart Webhook formatını standardize eder. Polling 'simple but expensive'; Webhook 'efficient but reliability gerektirir' (retry, dead-letter queue).

iPaaS: Integration Platform as a Service

Gartner 'Magic Quadrant for Enterprise iPaaS' 2024: işletmelerin %72'si iki+ farklı SaaS sistemini bağlamak için iPaaS kullanıyor. Lider çözümler: MuleSoft, Boomi, Workato, Zapier, Make.com (eski Integromat). Türkiye SaaS pazarında Logo Connect, Bordro Plus iPaaS özellikleri sunuyor. iPaaS yatırımı 'no-code integration' fırsatı, ama 'her şey iPaaS' anti-pattern — kritik mantık iPaaS'a koyulmamalı.

Veri sözlüğü ve şema yönetimi

Sistem entegrasyonunun #1 problemi: veri tanımı farkı. 'Müşteri' bir sistemde kişi, başka sistemde firma. ISO/IEC 11179 'Information technology — Metadata registries' bu sorunun standart çözümü. Pratik araç: data dictionary (örnek/açıklama/format), Schema Registry (Confluent, Apicurio). Her entegrasyon öncesi alan-alan mapping dokümanı yapılmalı.

TÜBİTAK Açık API programı

TÜBİTAK 'TÜBİTAK SAGE Açık API Geliştirme Programı' (2024 başlatıldı) Türkiye kamu kuruluşları için OpenAPI 3.1 standartlaştırma çalışması yürütüyor. SGK, GİB, MERSİS, Sigorta Bilgi Merkezi pilot kapsamında. Bu trend ekosistem entegrasyonlarının önümüzdeki 3 yılda hızlanacağını gösteriyor.

Pratik karar matrisi

Hangi entegrasyon ne zaman? (a) Real-time, tek yönlü olay → Webhook. (b) Real-time, çift yönlü sorgu → REST/GraphQL. (c) Batch (gece) toplu transfer → SFTP veya event-driven CSV. (d) Düşük frekanslı, manuel veri kontrol → iPaaS. (e) Yüksek-volume internal microservices → gRPC. KontrolJet ekosistem ürünleri arası entegrasyon (a) + (b) kombinasyonu kullanır.

Özet çıkarımlar

  • ISO/IEC 25010 'Interoperability' standart kalite boyutudur.
  • OpenAPI 3.1 modern REST API standartı.
  • Webhook + retry/DLQ polling'den verimli ama reliability gerekir.
  • Veri sözlüğü her entegrasyon öncesi yapılmalı (ISO/IEC 11179).

Kaynakça

Bu yazı aşağıdaki uluslararası kaynaklardan sentezlenip Türkiye mevzuat bağlamına uyarlanmıştır. Doğrudan çeviri yapılmamıştır.

  1. ISO/IEC 25010:2011 Systems and software Quality Requirements and Evaluation. International Organization for Standardization. https://www.iso.org/standard/35733.html (erişim: 2026-05-13)
  2. OpenAPI Specification 3.1. OpenAPI Initiative. https://spec.openapis.org/oas/v3.1.0 (erişim: 2026-05-13)
  3. CloudEvents Specification. Cloud Native Computing Foundation (CNCF). https://cloudevents.io/ (erişim: 2026-05-13)
  4. Magic Quadrant for Enterprise iPaaS. Gartner. https://www.gartner.com/en/documents/magic-quadrant-ipaas (erişim: 2026-05-13)
  5. ISO/IEC 11179 Information technology — Metadata registries. International Organization for Standardization. https://www.iso.org/standard/35343.html (erişim: 2026-05-13)
#api#iso-25010#webhook#ipaas#openapi