İçeriğe geç
DESTEK SİSTEMİ
API ve Sistem Entegrasyonu

Birbiriyle çelişmeyi bırakan sistemler

Operasyonel sıkıntının çoğu, aynı gerçeğin farklı sürümlerini tutan iki sistemden kaynaklanır. Hangisinin doğru cevap olduğunu belirleyen API’leri, webhook’ları ve senkronizasyonu tasarlar ve kurarız — ve çelişki oluştuğunda bunu görünür kılarız.

Entegrasyon bir tesisat değil, bir veri sorunudur

İki sistemi bir haftalığına bağlamak kolaydır. Zor olan kırkıncı günde olanlardır: bir tarafta olup diğerinde olmayan kayıt, iki kez gelen güncelleme, bir sistemin kırptığı alan, bir saatlik olayı sessizce düşüren kesinti. Bu yüzden önce hata durumlarına göre tasarlarız. Her gerçeğin sahibi hangi sistem. Bir çağrı zaman aşımına uğradığında ne oluyor. Yinelenen kayıt nasıl tanınıyor. Başarısız bir mesaj nereye gidiyor ve bunu kim öğreniyor. Bir mutabakat raporu neye benziyor ve gerçekte ne sıklıkla okunuyor. Aynı disiplin, sizin dışarıya açacağınız API’ler için de geçerlidir: sürümlenmiş, belgelenmiş, kimlik doğrulamalı, hız sınırlı ve entegre olan bir iş ortağının, dokümantasyonun zaten yanıtlaması gereken bir soruyu size sormak zorunda kalmayacağı şekilde tasarlanmış.

Temel faydalar

Bunun işiniz için değiştirdiği şeyler.

Tek bir gerçek sürümü

Her gerçeğin sahipliği açıkça belirlenir; böylece iki sistem aynı anda hem haklı olup hem çelişemez.

Görünür hatalar

Yeniden denemeler, ölü mektup kuyrukları ve bir mesaj teslim edilemediğinde uyarı — sessizce kaybolan bir saatlik veri yerine.

Manuel yeniden giriş ortadan kalkar

Birinin iki sistem arasında kopyalayarak geçirdiği günlük yarım saat, bu işin getirisidir.

Okuyabileceğiniz mutabakat

Neyin eşleştiğini ve neyin eşleşmediğini gösteren planlı bir rapor; böylece sapma yıl sonunda değil günler içinde yakalanır.

Neler teslim ediyoruz

Gerçekte elinize geçenler.

  • REST API tasarımı ve geliştirmesi

    Sürümlenmiş, belgelenmiş ve tutarlı; bir iş ortağının istemci üretebileceği bir OpenAPI tanımıyla.

  • Webhook’lar ve olay teslimi

    İmzalı yükler, idempotency anahtarları, yeniden deneme politikası ve tüketicinin inceleyebileceği bir teslim günlüğü.

  • Üçüncü taraf entegrasyonları

    Ödeme sağlayıcıları, kargo firmaları, muhasebe, e-fatura, CRM, e-imza ve mesajlaşma.

  • ERP ve CRM konektörleri

    Sonradan keşfedilen değil, önceden kararlaştırılmış çakışma kurallarıyla çift yönlü senkronizasyon.

  • API’ler için kimlik doğrulama

    OAuth 2, API anahtarları ya da imzalı istekler; kapsamlarla, böylece bir iş ortağı tam olarak ihtiyaç duyduğunu alır.

  • Veri göçü ve tek seferlik senkronizasyonlar

    Eşleme, temizleme ve hiçbir şey yazılmadan önce inceleyebileceğiniz bir prova.

Temel yetkinlikler

Bu hizmetin dayandığı mühendislik alanları.

REST ve JSON:API tasarımı
Webhook’lar ve olay akışları
OAuth 2 ve API anahtarları
Hız sınırlama ve kotalar
Yeniden deneme ve idempotency
Veri eşleme ve göçü
Mutabakat raporlaması
OpenAPI dokümantasyonu
Entegrasyon izleme
Ödeme geçidi entegrasyonu

Kullandığımız teknolojiler

Başvuracağımız teknoloji yığını ve her parçanın ne işe yaradığı.

Laravel

Kimlik doğrulama, kuyruklar ve test altyapısı hazır gelen; güvenli ve bakımı kolay sunucu taraflı uygulamalar ve API’ler için olgun bir PHP çatısı.

PHP

Web’in büyük bölümünü çalıştıran dil; PHP 8 ile birlikte hızlı ve katı tip desteğine sahip.

Node.js

Çok sayıda bağlantının zamanının çoğunu beklemekle geçirdiği gerçek zamanlı özellikler ve API geçitleri için uygun bir JavaScript çalışma ortamı.

TypeScript

JavaScript üzerine statik tipler. Birden fazla kişinin baktığı bir kod tabanında bir grup çalışma zamanı hatasını derleme zamanına taşır.

PostgreSQL

JSON, tam metin arama ve coğrafi veri desteği güçlü bir ilişkisel veritabanı; düz tabloları aşan modeller için.

Redis

Önbellekleme, kuyruklar ve hız sınırlama için bellek içi depo: veritabanını bekleyen sayfa ile beklemeyen sayfa arasındaki fark.

Docker

Konteynerler: geliştiricinin yerelde çalıştırdığı uygulama ile üretimdeki uygulamanın aynı çıktı olmasını sağlar.

AWS

Yönetilen veritabanları, depolama ve ağ hizmetleriyle bulut altyapısı; kapasite satın alma siparişini değil talebi izler.

Teknoloji kullanımı

Bu yığındaki teknolojilerin, aşağıdakiler de dâhil olmak üzere çeşitli kuruluşlar tarafından kullanıldığı kamuya açık kaynaklarda belgelenmiştir.

Netflix

Node.js

Kaynak

Slack

TypeScript

Kaynak

Bu kuruluşlar, listelenen teknolojilerin belgelenmiş kullanıcıları olarak anılmaktadır. Vertex Arc’ın müşterisi değildirler ve burada yer almaları Vertex Arc ile herhangi bir ilişki ya da onay anlamına gelmez.

Hizmet verdiğimiz sektörler

Bu hizmetin genellikle iyi oturduğu sektörler.

  • FinTech
  • Lojistik
  • E-Ticaret
  • Sağlık
  • SaaS
  • Üretim

Teslim sürecimiz

Bir işin ilk görüşmeden sürekli desteğe kadar nasıl ilerlediği.

  1. Keşif

    Yazılımın ne yapması gerektiğini, kimin kullandığını ve hangi kısıtların gerçek olduğunu çıkarırız. Çıktı bir teklif değil, yazılı bir kapsamdır.

  2. Mimari

    Veri modeli, sınırlar, entegrasyonlar ve altyapı; kimse uygulama kodu yazmadan önce kararlaştırılır ve mutabık kalınır.

  3. Tasarım

    Akışlar ve arayüz; ürünün gerçekte nasıl hissettirdiğini belirleyen boş, hatalı ve yetkisiz durumlar dâhil.

  4. Geliştirme

    Alışıldık bir yapı üzerinde gözden geçirilebilir artışlarla; bozulması pahalıya patlayacak yerlerde testlerle.

  5. Kalite ve güvenlik

    Yayına almadan önce işlevsel testler, performans kontrolleri ve kimlik doğrulama, yetkilendirme ile bağımlılık riskinin incelenmesi.

  6. Yayına alma

    Dağıtım, izleme ve gerçek trafiğin hazırlık ortamının bulamadığını bulduğu dönemde yakın takip.

  7. Sürekli iyileştirme

    Destek sistemi üzerinden yamalar, yükseltmeler ve yeni işler; böylece ürün sessizce yaşlanmak yerine bakımlı kalır.

Kullanım senaryoları

Bunun bitmiş bir ürün olarak görünüşü.

Mağazadan ERP’ye senkronizasyon

Sipariş, stok ve fiyatların kimse CSV dışa aktarmadan vitrin ile arka ofis arasında hareket etmesi.

İş ortağı API’si

Platformunuzun bir bölümünü müşterilere veya bayilere açmak; anahtarlar, kapsamlar, kotalar ve dokümantasyonla.

Satın alma sonrası birleştirme

İki şirket, iki CRM, tek müşteri listesi — eşlenmiş, yinelenenlerden arındırılmış ve geçiş boyunca senkron tutulmuş.

Neden Vertex Arc

Hata durumuna göre tasarlarız

Zaman aşımları, yinelenenler ve kısmi yazmalar baştan kararlaştırılır; çünkü entegrasyonların gerçekte bozulduğu yer orasıdır.

Sıradaki kişi için belgelenmiş

Bir OpenAPI tanımı ve yazılı bir veri sahipliği haritası; böylece entegrasyon tek bir kişinin bilgisi olmaktan çıkar.

Varsayılmaz, izlenir

Her entegrasyon sağlık kontrolleri ve uyarı sistemiyle çıkar. Sessizlik, çalıştığının kanıtı değildir.

Bir entegrasyon kırılgansa söyleriz

Bazı sağlayıcı API’leri belgelenmemiş, hız sınırlı ya da kararsızdır. Bunu iş başladıktan sonra değil, öncesinde duyarsınız.

Sıkça sorulan sorular

Bağlanmamız gereken sistemin API’si yok. Şimdi ne olacak?
Genellikle seçenekler vardır: planlı dosya dışa aktarımı, veritabanı replikası ya da desteklenen bir içe aktarma biçimi. Hangisinin güvenli, hangisinin bakım yükü olduğunu söyler ve ikisini de dürüstçe fiyatlarız.
API’sini değiştiren bir sağlayıcıyı nasıl ele alıyorsunuz?
Sürüm sabitleme, CI’da çalışan sözleşme testleri ve izlenen bir entegrasyon; böylece kırıcı bir değişiklik müşteri şikâyeti olarak değil bir uyarı olarak ortaya çıkar.
Başkasının kurduğu bir entegrasyonu devralabilir misiniz?
Evet. Salt okunur bir incelemeyle başlarız: ne yapıyor, nerede tıkanıyor, neyi belgelenmemiş. Onarım mı değiştirme mi kararını vermeden önce bunu yazılı bir değerlendirme olarak alırsınız.