Hisarcık, Kütahya: Ö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

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.

Sürümlü API

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

OpenAPI dokümantasyonu

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

Geliştirici portalı

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.

03Özel API servisi planlarken bilinmesi gerekenler

hata kodu standardı.
oran sınırı ve kota
kimlik doğrulama (API anahtarı, OAuth 2.0)

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
İş ortakları API'yi yanlış kullanıyor	Dokümantasyon eksik veya güncel değil	OpenAPI şeması, örnek istekler ve sürüm notları

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 birimler	Onay ve yetki
Birim sorumlusu	Kendi birimi	Onay, atama, rapor
Kullanıcı	Kendi kayıtları	Giriş ve takip
Denetçi	Salt okunur raporlar	Dışa aktarım

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

İş 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.
Kurumsal BT ekipleri: Özel API servisi, kurumsal BT ekipleri için iş akışına göre uyarlanır.

08Hisarcık için özellik planı

PTT kayıtlarında Hisarcık ilçesine bağlı 37 yerleşim bulunur: 6 mahalle ile 31 köy ve köy yerleşimi.

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

Kütahya genelinde Tavşanlı, Simav ve Dumlupınar 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.

Hemen ara WhatsApp Teklif formu

SSSSık sorulan sorular

Hisarcık'tan 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.

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.

Ö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 Kütahya için mi çalışıyorsunuz?

Hayır, Türkiye'nin her ilindeki işletmelerle çalışıyoruz; Ege Bölgesi dahil tüm bölgelerde süreç aynı düzenle yürü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.

API'yi kimlerin kullandığını nasıl izleriz?

Her istemciye ayrı anahtar veya OAuth istemcisi verilir; kullanım, hata ve kota tüketimi istemci bazında raporlanı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.

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

Hisarcık'ta ilgili hizmetler

Kütahya içindeki diğer ilçeler

Genel sayfalar

Bu sayfada geçen kavramlar

sürümleme
kota
izleme
SSO
rate limit
OpenAPI
OAuth 2.0
SDK
webhook
Kütahya
Hisarcık

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