Developer Portal
Çalıştığınız firmalar için kendi API portalınız
Tedarikçiler, bayiler ve partnerler markalı portalınıza kaydolur, API referansını okur, kendi anahtarlarını oluşturur ve çağırmaya başlar. Önce test, sonra canlı. API bazında siz seçersiniz: çağrılar DataSynca üzerinden geçsin, arkadaki sistemleriniz ve kimlik bilgileriniz görünmesin; ya da tedarikçiler sizin API anahtarınızı kullansın, portal dokümantasyonu ve erişimi yönetsin.
Developer portal nedir?
Developer portal, API'lerinizin ön kapısıdır: dokümantasyon, kayıt, anahtar ve destek tek yerde durur; dışarıdan bir geliştirici BT ekibinize ticket açmadan entegre olabilir. Çoğu şirket bunu ya sıfırdan yazar ya da entegrasyon platformunun yanında ayrı bir ürün olarak işletir.
DataSynca Developer Portal kendi alan adınızda, kendi markanızla çalışır ve zaten işlettiğiniz API Gateway ile akışların doğrudan üzerinde durur. Tek kurulum, tek denetim izi, işletilecek ayrı bir ürün yok. Her API'yi istediğiniz gibi yayınlarsınız: DataSynca üzerinden geçerek ya da sizin verdiğiniz anahtarlarla doğrudan çağrılarak — katalog, dokümantasyon, kayıt ve onay her durumda DataSynca'da.
Bir çağrı nasıl ilerler
Tedarikçi → portal adresiniz → DataSynca → API'niz
API DataSynca üzerinden geçiyorsa anahtar, yetki, kota ve istek doğrulaması, çağrı arkadaki API'nize ulaşmadan önce kontrol edilir. Kendi anahtarınızla yayınladığınız API'ler bu yoldan geçmez; tedarikçiler onları doğrudan çağırır.
Canlı — dsp_live_ anahtarları
Authorization: Bearer dsp_live_••••Tedarikçi uygulaması
Partner, bayi, toptancı
Portal adresiniz
api.sirketiniz.com
DataSynca
Anahtar · yetki · kota · doğrulama
Arkadaki API'niz
Adres ve kimlik bilgileri gizli
Test — dsp_test_ anahtarları
Authorization: Bearer dsp_test_••••Tedarikçi uygulaması
Portal adresiniz
DataSynca
Test sistemi veya simülatör
Yanıtlar OpenAPI dokümanından
Canlı adreste test anahtarı ya da test adreste canlı anahtar, hiçbir yere ulaşmadan reddedilir.
DataSynca üzerinden geçen her çağrı kayda geçer
Çağrılar ve Raporlar her isteği firma, kullanıcı, API, sürüm ve ortam bazında gösterir — maskelenmiş detay ve CSV dışa aktarımıyla.
Ekipler bunu neden ister
Developer portalın çözdüğü durumlar
Entegrasyon ekiplerine satıştan, satın almadan ve partnerlerden gelen talepler bunlar. Developer Portal tam bunun için.
Tedarikçi ve bayi devreye alma
Yeni bir toptancı kaydolur, ihtiyaç duyduğu müşteri tipi ve ortam için onaylarsınız, aynı gün sipariş API'nizi çağırmaya başlar. E-posta zinciri yok, paylaşılan şifre yok.
Doğrudan açamayacağınız API'ler
ERP'niz ya da eski API'niz internet için tasarlanmadı. DataSynca üzerinden geçirin: portal onu sizin alan adınızda yayınlar, gerçek adres ve kimlik bilgileri DataSynca'da kalır.
Önce test, sonra canlı
Partnerler test ortamında geliştirir — simülasyon ya da gerçek test yanıtlarıyla — ve canlıya ancak siz onlara açtığınızda geçer.
Eski sürümü temiz kapatmak
Sürümü bir notla ve kapanış tarihiyle kullanımdan kaldırın. Uyarı başlıklarıyla çalışmaya devam eder, kullanan her firmaya haber gider, tarih geçince siz emekliye ayırırsınız.
Ne kazanırsınız
Eksiksiz bir partner API programı — bir dokümantasyon sayfası değil
Developer Portal, bir firmanın ilk kaydından aylık kullanım raporuna kadar tüm yolu kapsar.
Sizin adresiniz, sizin markanız
Portalı size ait bir alan adında çalıştırın: logonuz, renkleriniz, karşılama ve kullanım şartları metniniz, kendi tasarladığınız portal sayfaları. Türkçe, İngilizce ya da ikisi birden.
Kayıt ve onay
Firmalar kendileri kaydolur. Siz müşteri tipi ve ortam bazında onaylar, mevcut bir firmaya bağlar, hazır olduklarında canlıyı açarsınız.
Test ve canlı anahtarlar
Tedarikçiler kendi dsp_test_ ve dsp_live_ anahtarlarını oluşturur. Arkadaki sisteme dokunmadan yenileyin, iptal edin, geçerlilik süresi ve anahtar başına limit belirleyin.
OpenAPI'den API Ürünleri
OpenAPI 3 veya Swagger 2 dokümanlarını aktarın, uç noktaları her müşteri tipinin çağırabileceği ürünlerde gruplayın. DataSynca üzerinden geçen API'lerde istek doğrulaması yapılır; kendi anahtarınızla yayınlananlar dokümanın tanımladığı güvenlikle dokümantasyon olarak sunulur.
Kota ve hız limitleri
Limit politikaları zaman penceresi başına çağrı sayısını ve firma başına aylık kotayı belirler. Tedarikçi kotasını portalda görür; siz tüm firmalarınkini tek sayfada.
Raporlar ve çağrı kaydı
Firma, kullanıcı, API, sürüm ve ortam bazında çağrılar, hata oranları, yanıt süreleri ve kota kullanımı — CSV dışa aktarımı ve maskelenmiş istek/yanıt detaylı çağrı kaydıyla.
Nasıl çalışır
İlk API'den işleyen bir partner programına
- 1
Portalı kurun
Alan adını seçin, markanızı, e-posta göndericinizi ve kullanım şartlarınızı ekleyin, portalı DataSynca kurulumunuzun içinde açın.
- 2
API'lerinizi aktarın
Bir OpenAPI dokümanı yükleyin, bir adresten çekin ya da bir DataSynca akışını API olarak yayınlayın. Test ve canlı sistemleri tanımlayın — ya da testin yanıtları simüle etmesine izin verin.
- 3
Kimin neyi çağıracağını belirleyin
Uç noktaları API Ürünlerinde gruplayın, tedarikçi veya toptancı gibi müşteri tiplerine atayın, limit politikalarını belirleyin.
- 4
Onaylayın, izleyin, geliştirin
Kayıtları onaylayın, partner hazır olunca canlıyı açın, Çağrılar ve Raporlar'ı izleyin, eski sürümleri kapanış tarihiyle kullanımdan kaldırın.
Karar vermeden önce
Entegrasyon ekiplerinin ilk sorduğu sorular
İlk görüşmede genellikle gündeme gelen konulara kısa cevaplar.
Tedarikçiler iç sistemlerimize erişiyor mu?
Siz istemedikçe hayır. DataSynca üzerinden geçen bir API'de tedarikçiler portal adresinizi kendi anahtarlarıyla çağırır; DataSynca anahtarı, firmanın yetkilerini, limitleri ve istek biçimini kontrol eder, sonra çağrıyı kurulumunuzun içinde saklanan kimlik bilgileriyle arkadaki API'nize iletir. Arkadaki adres ve kimlik bilgileri onlara hiç gösterilmez. Kendi anahtarınızla yayınladığınız bir API'de ise sizin verdiğiniz anahtarlarla, sizin yayınladığınız adresi çağırırlar.
Tüm çağrılar DataSynca üzerinden geçmek zorunda mı?
Hayır. API bazında siz karar verirsiniz. Proxy modunda DataSynca anahtarı, firmanın yetkilerini, limitleri ve istek biçimini kontrol eder, çağrıyı iletir ve Çağrılar ile Raporlar'a kaydeder; arkadaki adres ve kimlik bilgileri gizli kalır. Kendi anahtar modunda tedarikçiler API'nizi sizin verdiğiniz anahtarlarla doğrudan çağırır; DataSynca kataloğu, dokümantasyonu, kaydı ve onayı barındırır, hiçbir çağrı iletilmez veya sayılmaz.
Tedarikçiler DataSynca hesabı olmadan portalı kullanabilir mi?
Evet. Portal hesapları DataSynca kullanıcılarından ayrıdır. Tedarikçi portala kaydolur, e-postasını doğrular, onayınızı bekler ve sonra anahtarlarını, kullanımını ve taleplerini orada yönetir. Portal hesapları DataSynca konsolunuza giriş yapamaz.
Test ve canlı nasıl çalışır?
Her API sürümünün kendi arka sistemine sahip bir test ve bir canlı ortamı vardır. Test anahtarları dsp_test_ ile başlar ve yalnız test adreslerinde çalışır; canlı anahtarlar dsp_live_ ile başlar ve yalnız canlı adreslerde çalışır. Test, gerçek bir sistemi çağırmak yerine OpenAPI dokümanından yanıt verebilir.
Bir firma kotasını aşarsa ne olur?
Limit politikası karar verir: ya sonraki aya kadar yeni çağrılar reddedilir ya da çağrılar sürer ve kota bir uyarı eşiği gibi çalışır. Kota dolarken firma yetkililerine ve yöneticilerinize e-posta gider; her yanıt limit ve kota başlıklarını taşır.
Portal ayrı bir lisans ya da altyapı gerektiriyor mu?
Hayır. Developer Portal size özel DataSynca kurulumunuzun bir parçasıdır. Kurulumunuza yönlendirilmiş bir alan adı ve gönderdiği e-postalar için bir SMTP hesabı yeterlidir. Hangi API'lere ve firmalara hizmet vereceğini sizinle birlikte planlarız.
Sistemlerinizi açmadan API'lerinizi partnerlere açmak mı istiyorsunuz?
Hangi API'ler ve hangi firmalar olduğunu anlatın. Developer Portal'ın size özel kurulumunuza nasıl uyduğunu gösterelim.