Özel API Servisi Özellikleri ve Modülleri

Dış sistemlere veri/servis sunan API ürünü.

01Olmazsa olmaz özellikler

sürümleme
kota
izleme

02İhtiyaca göre eklenen modüller

İmzalı webhook

İmzalı webhook, ihtiyaç netleştiğinde özel API servisi içine ayrı bir modül olarak eklenebilir; ilk sürümde zorunlu değildir.

Kota ve oran sınırı

Bu modül, iş akışınız gerektiriyorsa kapsamın başında konuşulur; aksi halde sonraki sürüm planına bırakılabilir.

OpenAPI dokümantasyonu

OpenAPI dokümantasyonu için kimin kullanacağı ve hangi veriye ihtiyaç duyulacağı analizde belirlenir.

SSO ve OAuth

SSO ve OAuth, ihtiyaç netleştiğinde özel API servisi içine ayrı bir modül olarak eklenebilir; ilk sürümde zorunlu değildir.

03Özel API servisi planlarken bilinmesi gerekenler

kimlik doğrulama (API anahtarı, OAuth 2.0)
hata kodu standardı.
OpenAPI dokümantasyonu

04Sık karşılaşılan durumlar

Durum	Olası neden	Çözüm
Webhook bildirimleri kayboluyor	Yeniden deneme ve teslim kaydı yok	İmzalı webhook, kuyruk ve teslim logu
Eski sürümü kullananlar bozuluyor	Sürümleme ve geçiş takvimi yok	Sürümlü uç noktalar ve duyurulu kullanım dışı bırakma
API yoğunlukta yavaşlıyor	Kota ve önbellek yok, sorgular optimize değil	Oran sınırı, önbellek ve sorgu iyileştirme

05Kullanıcı rolleri ve yetkiler

Örnek rol yapısıdır; gerçek roller analizde işletmeye göre belirlenir.
Rol	Görebilir	Yapabilir
Yönetici	Tüm kayıtlar ve raporlar	Kullanıcı ve ayar yönetimi
Çalışan	Kendi işleri ve atananlar	Kayıt girişi ve güncelleme
Müşteri / bayi	Kendi kayıtları	Talep ve sipariş

06Raporlar ve mobil kullanım

Rapor ihtiyacı, kararların hangi rakamlara bakılarak verildiği sorusuyla belirlenir; her rapor bir karara hizmet etmelidir.

Arayüz mobil uyumlu tasarlanır; sahada veya yolda olan kullanıcılar tarayıcıdan aynı ekranlara erişir. Kamera, barkod veya çevrimdışı kullanım gerekiyorsa mobil uygulama değerlendirilir.

07Sektöre göre özellik önerileri

Veri sağlayıcıları: Özel API servisi, veri sağlayıcıları için iş akışına göre uyarlanır.
İş ortağı ekosistemi olan firmalar: Özel API servisi, iş ortağı ekosistemi olan firmalar için iş akışına göre uyarlanır.
Platform kuran girişimler: Özel API servisi, platform kuran girişimler için iş akışına göre uyarlanır.
Yazılım şirketleri: Özel API servisi, yazılım şirketleri için iş akışına göre uyarlanır.

08İpekyolu için özellik planı

İpekyolu, Van iline bağlı bir ilçedir ve PTT adres verisine göre 50 mahalleden oluşur.

Yazılım projelerinde analiz, tasarım ve geliştirme çoğunlukla uzaktan, görüntülü toplantılarla yürür; İpekyolu'ndaki 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.

Van genelinde Özalp, Van Saray ve Bahçesaray gibi diğer ilçelerdeki işletmelerle de aynı uzaktan çalışma düzeniyle ilerlenir.

İpekyolu bölgesinden özel API servisi için ilk görüşmeyi telefonla yapabiliriz: 0540 003 19 81. İsterseniz kısa bir not bırakın, biz arayalım.

Hemen ara WhatsApp Teklif formu

SSSSık sorulan sorular

Tüm özellikler ilk sürümde mi olmalı?

Hayır. İlk sürüm en çok zaman kaybettiren işi çözmeye odaklanır; diğer özellikler kullanım verisi ve geri bildirimle sürüm planına alınır.

Kullanıcı rolleri nasıl belirlenir?

Kimin neyi göreceği, kimin neyi onaylayacağı mevcut iş akışından çıkarılır ve bir yetki matrisiyle belgelenir.

Ö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.

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.

İpekyolu'nda bulunuyorum, yerinde görüşme mümkün mü?

Toplantılar görüntülü yapılır ve ekran paylaşımıyla ilerler. Cihaz kurulumu, saha incelemesi veya ekip eğitimi gibi yerinde bulunmayı gerektiren adımlar ayrıca planlanı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.

Sadece Van için mi çalışıyorsunuz?

Askadar Yazılım 81 ilde uzaktan çalışır; Van de bunlardan biridir. Yerinde iş gerektiğinde ziyaret planlanır.

Hangi özellik ilk sürümde olmalı?

Her gün kullanılacak ve en çok zaman kazandıracak özellikler ilk sürümde olmalıdır; diğerleri kullanım verisine göre eklenir.

→İlgili sayfalar

Özel API Servisi hakkında diğer konular

İpekyolu'nda ilgili hizmetler

Van içindeki diğer ilçeler

Genel sayfalar

Bu sayfada geçen kavramlar

sürümleme
kota
izleme
SSO
rate limit
OpenAPI
geliştirici portalı
Swagger
Van
İpekyolu

Özel API servisi: olması gereken özellikler ve modüller (İpekyolu)