Türkiye'nin 81 ilinde yazılım hizmeti · 0540 003 19 81
API ve Geliştirici Araçları · Ezine, Çanakkale

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

Bir özel API servisi projesinde özellik listesi büyüdükçe maliyet ve süre de büyür. Hangi özelliğin ilk sürümde, hangisinin sonra gelmesi gerektiğini ayırmak için aşağıdaki listeyi kullanabilirsiniz.

Kısa cevap

Özel API servisi için olmazsa olmaz özellikler: sürümleme, kota ve izleme. Diğer modüller ihtiyaca göre sonraki sürümlere eklenir. Bilgi için 0540 003 19 81 numarasını arayabilir veya WhatsApp'tan yazabilirsiniz.

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

01Olmazsa olmaz özellikler

  • sürümleme
  • kota
  • izleme

02İhtiyaca göre eklenen modüller

OpenAPI dokümantasyonu

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

Geliştirici portalı

Geliştirici portalı için kimin kullanacağı ve hangi veriye ihtiyaç duyulacağı analizde belirlenir.

Sürümlü API

Sürümlü API için kimin kullanacağı ve hangi veriye ihtiyaç duyulacağı analizde belirlenir.

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

03Özel API servisi planlarken bilinmesi gerekenler

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

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

DurumOlası nedenÇözüm
Eski sürümü kullananlar bozuluyorSürümleme ve geçiş takvimi yokSürümlü uç noktalar ve duyurulu kullanım dışı bırakma
İş ortakları API'yi yanlış kullanıyorDokümantasyon eksik veya güncel değilOpenAPI şeması, örnek istekler ve sürüm notları
API yoğunlukta yavaşlıyorKota ve önbellek yok, sorgular optimize değilOran 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.
RolGörebilirYapabilir
YöneticiTüm birimlerOnay ve yetki
Birim sorumlusuKendi birimiOnay, atama, rapor
KullanıcıKendi kayıtlarıGiriş ve takip
DenetçiSalt okunur raporlarDışa aktarım

06Raporlar ve mobil kullanım

Raporlar ilk günden çok sayıda olmamalı; yöneticinin her hafta baktığı birkaç temel rapor kurulur, kullanıldıkça zenginleştirilir.

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

  • Platform kuran girişimler: Özel API servisi, platform kuran girişimler 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.
  • Kurumsal BT ekipleri: Özel API servisi, kurumsal BT ekipleri için iş akışına göre uyarlanır.
  • Veri sağlayıcıları: Özel API servisi, veri sağlayıcıları için iş akışına göre uyarlanır.

08Ezine için özellik planı

PTT kayıtlarında Ezine ilçesine bağlı 70 yerleşim bulunur: 12 mahalle ile 58 köy ve köy yerleşimi.

Ezine'de bulunan bir işletmeyle çalışırken toplantılar görüntülü yapılır, her aşama test ortamında paylaşılır ve geri bildirimler ortak panoda toplanır; yerinde bulunmak gereken kurulum ve eğitim adımları ayrıca planlanır.

Çanakkale genelinde Eceabat, Çanakkale Yenice ve Çanakkale Merkez gibi diğer ilçelerdeki işletmelerle de aynı uzaktan çalışma düzeniyle ilerlenir.

Özel API servisini planlıyorsanız 0540 003 19 81 numarasını arayın veya WhatsApp'tan ihtiyacınızı birkaç cümleyle yazın; teklif formunu da doldurabilirsiniz.

SSSSık sorulan sorular

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.

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.

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.

Ezine'den yazıyorum; toplantılar nasıl yapılıyor?

İşin büyük bölümü uzaktan yürür: ilk görüşme telefonla, sonraki toplantılar görüntülü yapılır. Kurulum ya da eğitim gerekiyorsa yerinde çalışma takvime eklenir.

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

Çanakkale dışındaki işletmelere de hizmet veriyor musunuz?

Hayır, Türkiye'nin her ilindeki işletmelerle çalışıyoruz; Marmara Bölgesi dahil tüm bölgelerde süreç aynı düzenle yürür.

Özellik listesini nasıl hazırlamalıyım?

Bugün nasıl çalıştığınızı, en çok zaman alan işi ve olmazsa iş yapılamayacak adımları yazmanız yeterli; teknik listeyi analizde birlikte çıkarırız.

Bu sayfada geçen kavramlar

  • sürümleme
  • kota
  • izleme
  • SSO
  • rate limit
  • OpenAPI
  • API anahtarı
  • Çanakkale
  • Ezine
Askadar Yazılım · Türkiye geneli

Aklınızdaki projeyi konuşalım.

Telefonla arayın veya WhatsApp'tan birkaç cümleyle yazın. Kapsam kısa bir görüşmeyle netleşir, teklif yazılı verilir.