Ö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

Geliştirici portalı

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

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.

Kota ve oran sınırı

Kota ve oran sınırı 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

oran sınırı ve kota
hata kodu standardı.
OpenAPI dokümantasyonu

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

Durum	Olası neden	Çözüm
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ı
Webhook bildirimleri kayboluyor	Yeniden deneme ve teslim kaydı yok	İmzalı webhook, kuyruk ve teslim logu

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.

Telefon ve tablette kullanılacak ekranlar sadeleştirilir; en sık yapılan işlem tek dokunuşla erişilebilir olur.

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.
Veri sağlayıcıları: Özel API servisi, veri sağlayıcıları için iş akışına göre uyarlanır.

08Payas için özellik planı

PTT kayıtlarında Payas ilçesine bağlı 14 yerleşim bulunur. Bu kayıtlardan 1 tanesi organize sanayi veya serbest bölge kaydıdır. Payas'ta 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. Payas'ta 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.

Aynı ildeki Antakya, Altınözü ve Kırıkhan ilçeleri için de özel API servisi talepleri değerlendirilir; toplantılar uzaktan yapılır.

Mevcut Excel dosyanızı veya ekran görüntülerinizi WhatsApp'tan gönderin; özel API servisi için hangi modüllerle başlanabileceğini konuşalım. Telefon: 0540 003 19 81.

Hemen ara WhatsApp Teklif formu

SSSSık sorulan sorular

Hatay dışındaki işletmelere de hizmet veriyor musunuz?

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

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

Payas'ta bulunuyorum, yerinde görüşme mümkün mü?

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

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.

Ö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

Payas'ta ilgili hizmetler

Hatay içindeki diğer ilçeler

Genel sayfalar

Bu sayfada geçen kavramlar

sürümleme
kota
izleme
SSO
rate limit
OpenAPI
webhook
API anahtarı
geliştirici portalı
Hatay
Payas

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