Ortahisar'da özel API servisi yaptırmak

01Özel API servisi ile neler yapılır?

Her işletmenin ihtiyacı farklıdır; yine de çoğu özel API servisi projesinde şu başlıklar konuşulur:

• izleme
• sürümleme
• kota

İhtiyaca göre API yönetim paneli ve geliştirici portalı, webhook servisi ve kimlik doğrulama ve SSO da aynı yol haritasına eklenebilir.

02Hangi durumlarda özel API servisi yaptırılır?

Verinizi iş ortaklarına açmak istediğinizde

Özel API servisi ile veri, yetki ve kota kontrolüyle güvenli biçimde dış sistemlere sunulur.

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.

Entegrasyon talepleri tek tek karşılandığında

Standart bir API ve dokümantasyon, her iş ortağı için ayrı geliştirme yapma ihtiyacını azaltır.

03Özel API servisi planlarken bilinmesi gerekenler

• oran sınırı ve kota
• kimlik doğrulama (API anahtarı, OAuth 2.0)
• OpenAPI dokümantasyonu

04Ortahisar için uzaktan ve yerinde çalışma

PTT kayıtlarında Ortahisar ilçesine bağlı 88 yerleşim bulunur. Bu kayıtlardan 1 tanesi organize sanayi veya serbest bölge kaydıdır. Ortahisar'da PTT verisine göre 1 OSB/SB kaydı bulunur; üretim ve tedarik zinciriyle çalışan işletmelerde özel API servisi için B2B süreçler ve mevcut programlarla entegrasyon ayrıca konuşulur.

Birden fazla ilçede ekibi veya şubesi olan işletmelerde özel API servisi 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: Ortahisar'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 Çarşıbaşı, Trabzon Köprübaşı ve Of ilçeleri için de özel API servisi talepleri değerlendirilir; toplantılar uzaktan yapılır.

05Çalışma adımları

1. İlk görüşme: İlk temas telefonla ya da WhatsApp'tan olur; işin kapsamını anlamak için birkaç temel soru sorarız.
2. Analiz: Ekranlar, raporlar ve entegrasyonlar için gerçek örnekler üzerinden ihtiyaç listesi çıkarılır.
3. Kapsam ve yazılı teklif: Hangi işin hangi aşamada teslim edileceği ve neyin kapsam dışı olduğu teklifte açıkça yazılır.
4. Tasarım ve prototip: Ekran akışları ve tasarımlar hazırlanır, onayınızdan sonra geliştirmeye geçilir.
5. Geliştirme ve test: Geliştirme aşamalı ilerler; her aşama test ortamında denenip onaylanır.
6. Yayın, veri aktarımı ve eğitim: Veri aktarımı doğrulandıktan sonra yayına geçilir; ekip için kısa kullanım kılavuzu hazırlanır.
7. Bakım ve destek: Yayın sonrası izleme, güncelleme ve geliştirme talepleri bakım planıyla sürdürülür.

06Örnek kapsam hesabı

07Nasıl çalışıyoruz?

Tasarım, geliştirme, test ve yayın adımları aynı ekip içinde yürür. Kod Git ile sürümlenir, kritik akışlar Playwright testleriyle korunur, yayın Docker konteynerleriyle tekrarlanabilir biçimde yapılır.

• Alan adı ve sunucu hesapları işletme adına açılır.
• Her değişiklik önce test ortamında denenir.
• Yayın sonrası bakım ve destek planlanır.

Türkiye'nin 81 ilindeki işletmelerle uzaktan çalışıyoruz: görüntülü toplantı, ekran paylaşımlı demo ve ortak proje panosu. Donanım kurulumu, depo barkod sistemi kurulumu, saha keşfi veya kullanıcı eğitimi gereken işlerde yerinde çalışma planlanır.

08Uzman desteği ne zaman şart olur?

Özel API servisi işlerinde bazı durumlar plansız ilerlerse sonradan pahalıya mal olur:

• Webhook bildirimleri kayboluyor: yeniden deneme ve teslim kaydı yok.
• Eski sürümü kullananlar bozuluyor: sürümleme ve geçiş takvimi yok.
• Kişisel veya finansal verinin işlendiği akışlar
• Birden fazla sistemle entegrasyon gerektiren işler

SSSSık sorulan sorular

→İlgili sayfalar

Bu sayfada geçen kavramlar

• sürümleme
• kota
• izleme
• SSO
• rate limit
• OpenAPI
• Swagger
• webhook
• Trabzon
• Ortahisar