Entegrasyon ve API
30 dakikalık iframe eklemesinden REST + gRPC üzerinde tamamen özel geliştirmeye kadar. Platform tek doğruluk kaynağı olarak kalır — UX'i, markayı ve dönüşüm hunisini siz kontrol edersiniz.
Canlı demo · kod yok
Backend değişikliği, migrasyon veya yeniden tasarım yok. Kısa ömürlü bir JWT imzalayın, aşağıdaki kod parçasını müşteri portalınıza yerleştirin — yatırımcılarınız ikinci bir giriş olmadan tamamen markanıza uyarlanmış B2COPY deneyimine ulaşır.
iframe snippet’ini kopyalayıp portalınızdaki herhangi bir sayfaya yapıştırın — liderlik tablosu, master profili, abonelik akışı, hepsi mobil uyumlu.
IdP'nizden harici JWT oluşturun, SideAuthenticate üzerinden değiştirin. Müşterileriniz ayrı bir B2COPY girişi görmez.
Sorgu parametreleri ve CSS token'ları aracılığıyla renklerinizi, tipografinizi ve dilinizi varsayılan olarak devralır.
Tek sözleşme
Her genel yöntem ortak `.proto` dosyalarında tanımlanır ve hem gRPC hem REST üzerinden sunulur. Altyapınıza uygun taşıma katmanını seçin — istek ve yanıt yapıları aynıdır.
Aynı .proto dosyalarından oluşturulan sürümlendirilmiş rotalar. CRM'ler, web uygulamaları, mobil istemciler ve kodsuz senaryolar için — HTTPS'in gRPC'den daha kolay olduğu her yerde kullanın.
Gecikme ve akışın önemli olduğu mikro hizmetler, iç ağ geçitleri ve yüksek verimli entegrasyonlar için Connect veya gRPC-Web kullanın. Her dilde tür güvenli, kodla oluşturulmuş istemciler.
API yüzeyleri
Üç hafif katman, tek protobuf sözleşmesi. Bunları bağımsız kullanın veya birleştirin — back office için Broker, kendi istemci uygulamanız için Frontend, pazarlama sitenizdeki yerleştirmeler için Widget.
Sunucudan sunucuya. CRM'iniz ve back office'iniz için tasarlandı — yönetici JWT, gömülü sahip verileriyle sayfalanmış hesap listeleri, copier ve PAMM bağlantıları için tam abonelik yönetimi.
Sunucudan sunucuyaKullanıcı adına. Kendi web veya mobil istemcinizi destekler: kimlik doğrulama, hesaplar, abonelikler, işlemler, ücretler, transferler, liderlik tablosu, grafikler, UI ayarları — girişten pozisyon kapatmaya kadar her şey.
Kullanıcı kapsamlıHerkese açık salt okunur yüzey. Tam istemci uygulaması olmadan pazarlama sitenizde master kartları, grafikler, liderlik tabloları ve abonelik kodu kontrolleri için daraltılmış bir katman.
Herkese açık · salt okunurAuthentication
Kiracı bazında kapsamlandırılmış, kullanıcı oturumlarından bağımsız olarak döndürülen EC imzalı token'lar. Entegrasyonun hiçbir tarafında parola işleme yoktur.
Back-office hizmetleriniz Broker API ile EC anahtarınızla imzalanmış yönetici JWT kullanarak kimlik doğrular. Token'lar kiracı kapsamlıdır ve kullanıcı oturumlarına dokunmadan döndürülebilir.
Broker APIMüşteri portalınızdan harici JWT oluşturun, SideAuthenticate veya AuthUserWithExternalToken üzerinden değiştirin, ardından normal kullanıcı kapsamlı çağrılara devam edin. Müşterileriniz için ikinci giriş yoktur.
Frontend APIBaşlangıç
Bir senaryo uçtan uca geliştiricinin 1–3 gününü alır. İki tipik ilk entegrasyon: web sitenizde liderlik tablosu (Widget API) veya CRM abonelik senkronizasyonu (Broker API).
01
Hazırlık ve üretim kimlik bilgilerini alın — Broker API için yönetici JWT, Frontend API için SSO kurulumu. Bir iş günü içinde sağlanır.
02
gRPC (Connect veya gRPC-Web) veya REST seçin. OpenAPI spesifikasyonu aynı .proto dosyalarından üretilir — stack’inize uyanı seçin.
03
Web sitenizde bir liderlik tablosu (LeaderboardList + ChartService) veya CRM abonelik senkronu (Broker LinkService). Bir senaryo 1–3 gün sürer.
04
Kullanıcı JWT’si ile SideAuthenticate → Frontend API zincirini kurun. Müşterileriniz portalınızdan B2COPY deneyimine yeniden kimlik doğrulaması olmadan geçer.
Üç entegrasyon yolu
Her yol belgelenmiş, desteklenmiş ve diğer brokerlar tarafından üretimde kullanılmaktadır. Bugün widget ile başlayın, daha sonra derin API entegrasyonu ekleyin — altyapınızın hiçbir parçasını taşımak zorunda değilsiniz.
En hızlı yol
Önceden oluşturulmuş bir widget'ı (liderlik tablosu, master profili, abone olma akışı) CRM'inize, müşteri alanınıza veya pazarlama sayfanıza ekleyin. İmzalı JWT üzerinden SSO sayesinde yatırımcılarınız B2COPY'ye zaten kimliği doğrulanmış ve markanıza göre temalandırılmış olarak ulaşır.
30 dakikada yayında
<!-- Add to your client portal -->
<iframe
src="https://widget.b2copy.com/copy"
data-sso-token="{{user.jwt}}"
data-theme="dark">
</iframe>
B2Core
+ IB Module
Nullpoint CRM
Ready
FX Back Office
ReadySıfır geliştirme
Zaten B2Core, Nullpoint veya FX Back Office mu kullanıyorsunuz? B2COPY hazır — özelliği açın, copy trading aynı gün müşteri alanınızda görünsün. B2Core entegrasyonu ayrıca partner programları için IB Module’ü açar.
Tam kontrol
Kendi copy trading UX’inizi sıfırdan oluşturun. CRM, web, mobil ve no-code için REST; yüksek performanslı gerçek zamanlı streaming için gRPC. Aynı protobuf sözleşmelerinden üretilir — taşımalar arasında semantik aynıdır. Sandbox + özel entegrasyon mühendisi dahildir.
2–3 hafta · sandbox + mühendis// REST APIGET/api/v1/copy/mastersPOST/api/v1/copy/subscriptionsGET/api/v1/copy/positionsPUT/api/v1/copy/subscriptions/{id}Kapsama genel bakış
Bunu boyutlandırma referansı olarak kullanın: CRM ekibiniz Broker API ile, istemci uygulamanız Frontend API ile ve pazarlama siteniz Widget API ile çalışır.
| Feature | Broker API Sunucudan sunucuya | Frontend API Kullanıcı adına | Widget API Herkese açık · salt okunur |
|---|---|---|---|
| Hesaplar ve kullanıcılar | Okumalar · sayfalanmış listeler | Tam CRUD + liderlik tablosu | Okumalar · abonelik kodu |
| Copier / PAMM abonelikleri | Tam yönetim | Tam yönetim | — |
| İşlem ve geçmiş | — | Pozisyonlar · işlemler · istatistikler | Pozisyonlar · istatistikler |
| Kârlılık ve grafikler | — | ✓ | ✓ |
| Ücretler ve promosyon kodları | — | ✓ | Aktif plan |
| Transferler | — | ✓ | — |
| Challenge’lar ve yarışmalar | — | ✓ | — |
| Auth / SSO | — | ✓ | — |
| UI ve platform ayarları | — | ✓ | Platform seviyesi |
Broker API
Yanıtlara gömülü sahip verileriyle abonelik yönetimi ve CRM dostu liste okumaları. EC anahtarınızla imzalanmış yönetici JWT ile kimlik doğrulaması yapar.
Çoğu CRM'in ilk günde ihtiyaç duyduğu temsili yöntemler — tam Broker API yüzeyi daha geniştir ve back-office modelinize uyacak şekilde istek üzerine genişletilir.
Tek bir çağrı; filtreler, sıralama ve temel sahip verileri (id, e-posta, takma ad, ülke) eklenmiş, sayfalanmış işlem hesapları listesi döndürür — CRM liste görünümleri için tasarlandı.
| Method | Purpose |
|---|---|
Listele | Filtreler, sıralama ve gömülü sahip verileriyle sayfalanmış işlem hesapları listesi — tek seferlik CRM görünümü için. |
| Method | Purpose |
|---|---|
Al | Bir B2COPY kullanıcı profilini alın. |
Listele | Sayfalanmış kullanıcı listesi. |
Copier ve PAMM abonelikleri için tam yönetim yüzeyi — oluşturma, güncelleme, silme, geri yükleme, ayrıntı alma ve filtrelerle listeleme.
| Method | Purpose |
|---|---|
CreateCopierLink | Bir Copy Trading aboneliği oluşturun (yatırımcı → master). |
CreatePAMMLink | PAMM aboneliği oluşturun. |
UpdateCopierSettings | Kopyalama ayarlarını güncelleyin. |
UpdatePAMMSettings | PAMM ayarlarını güncelleyin. |
Sil | Bir aboneliği devre dışı bırakın. |
Geri Yükle | Daha önce devre dışı bırakılmış bir aboneliği geri yükleyin. |
GetCopierLink / GetPAMMLink | Tek bir aboneliğin ayrıntıları. |
ListCopier / ListPAMM | Abonelikleri filtreler ve sayfalama ile listeleyin. |
Tipik senaryolar: abonelikleri CRM'inize senkronize etmek, destek araçlarından toplu işlemler yürütmek, broker tarafında master / yatırımcı onboarding'ini orkestre etmek. Listelenmeyen bir yönteme mi ihtiyacınız var — toplu yeniden atama, özel sahip verisi biçimi, iç araç endpoint'i? Kapsam belirleme sırasında bildirin; sonraki sürümde ekleriz.
Frontend API
Girişten pozisyon kapatmaya ve ücret ödemeye kadar her şey. Standart B2COPY istemci uygulamasını değiştirmek veya tamamlamak için kullanın — web ve mobilde çalışır, kullanıcıyı kısa ömürlü JWT ile SSO üzerinden doğrular.
Frontend API’nin temsilî bir dilimi — gerçek yüzey çok daha fazla servis, alan ve edge case kapsar. İstemci uygulama UX’inize uyması için talep üzerine genişletiriz.
| Method | Purpose |
|---|---|
Giriş | Platform kullanıcı adı / parolasıyla giriş yapın. |
AuthWithPlatformCredentials | İşlem hesabı kimlik bilgileriyle kimlik doğrulama. |
RefreshToken | Etkin oturumu yenileyin. |
AuthUserWithExternalToken / AuthAccountWithExternalToken | Harici token'lar üzerinden SSO — ikinci giriş olmadan B2COPY'yi müşteri alanınıza yerleştirin. |
SideAuthenticate / SideLoginWithToken | Broker portalınızdan sorunsuz yan giriş. |
API'deki en geniş hizmet — hesap yaşam döngüsünü, herkese açık liderlik tablosunu, master profillerini, finansları, abonelik kodlarını ve hesap türü yönetimini kapsar.
| Method | Purpose |
|---|---|
Oluştur | Mevcut bir MT veya cTrader hesabı üzerinde B2COPY hesabı oluşturun. |
Al / Güncelle | Hesap verilerini okuyun ve düzenleyin. |
LeaderboardList | Herkese açık master liderlik tablosu — filtreler, sıralama, en iyi N akışı. |
ListMyAccounts | Mevcut kullanıcıya ait hesapları listeleyin. |
ListAccountFinances | Hesap başına finansal metrikler. |
SetIsInLeaderboard | Bir master'ın liderlik tablosunda görünmesini açıp kapatın. |
CheckSubscriptionCode / GenerateSubscriptionCode / SetSubscriptionCode | Kapalı (yalnızca davetli) master'lar için abonelik kodları. |
GetMasterByLogin | Bir master'ı giriş bilgisine göre bulun. |
GetAccountView / UpdateAccountView | Master'ın herkese açık profil görünümü. |
SetMinimumDeposit | Abonelerden istenen minimum para yatırma tutarı. |
ResetPassword | Hesap parolasını sıfırlayın. |
ListAvailableAccountTypes | Platformda mevcut hesap türleri. |
| Method | Purpose |
|---|---|
CreateCopierLink / CreatePAMMLink | Kullanıcı adına abonelik oluşturun. |
UpdateCopierSettings | Kopyalama ayarlarını güncelleyin. |
Sil / Geri Yükle | Abonelikten çıkın ve geri yükleyin. |
ListSubscribersCopier / ListSubscriptionsCopier | Copier aboneleri ve abonelikleri. |
ListSubscribersPAMM / ListSubscriptionsPAMM | PAMM aboneleri ve abonelikleri. |
GetOverviewMaster / GetOverviewInvestor | Master veya yatırımcı rolü için özet görünümü. |
| Hizmet · Yöntem | Purpose |
|---|---|
PositionService.List / Close / Detach | Açık pozisyonlar, kapatma ve master'dan ayrılma. |
DealService.List | İşlem geçmişi. |
StatService.GetTradingStatistics | Gösterge panelleri ve raporlar için toplu işlem istatistikleri. |
| Hizmet · Yöntem | Purpose |
|---|---|
ReturnsService.List | Zaman dönemlerine göre getiriler. |
ProfitabilityService.GetPnlsByLinks | Abonelik başına K/Z. |
ChartService.Get / List | Master kartları için kârlılık grafikleri. |
| Hizmet · Yöntem | Purpose |
|---|---|
PlanService | Ücret planları oluşturun / alın, etkin planı veya promosyon koduna göre planı alın. |
PromoCodeService | Promosyon kodlarını oluşturun, güncelleyin, silin ve listeleyin. |
JobService | Ücret işlerini ve yatırımcı başına ödenen ücretleri listeleyin. |
CommissionSharingService | İş ortaklarıyla gelir paylaşımı — komisyon paylaşımı kurulumunu kaydedin ve okuyun. |
| Method | Purpose |
|---|---|
Oluştur | Hesaplar arasında transfer yapın. |
ListTransfers | Transfer geçmişi. |
ListMasterFees / ListInvestorFees | Transferlerle ilişkili ücretler. |
Cancel | Transferi iptal et. |
CanTransfer | Transferin mümkün olup olmadığını kontrol et. |
| Hizmet · Yöntem | Purpose |
|---|---|
SettingsService.GetSettings / SetSettings | PAMM hesap ayarları. |
RolloverService.Start | Rollover'ı tetikleyin. |
BalanceOperationService.List / SetCancelled (v2) | PAMM bakiye işlemleri. |
| Hizmet · Yöntem | Purpose |
|---|---|
ChallengeService.List | Etkin challenge'ları listeleyin — promosyon kampanyaları ve oyunlaştırma için temel. |
PersonalChallengeService | Kullanıcı katılımı ve kişisel ilerleme (oluşturma, ilerlemeyi alma, listeleme). |
StatisticsService.GetDailySummary | Yarışma liderlik tabloları için günlük özet. |
| Hizmet · Yöntem | Purpose |
|---|---|
RiskLimitService.SetLossLimit | Abonelik başına zarar limiti. |
RatioService.Get | Sembol oranları. |
TenantService.ListAllAvailable | Kullanılabilir ortamlar ve tenant’lar. |
CommonSettingsService.GetPlatformSettings | Global platform ayarları. |
MenuSettingsService.GetMenus | Uygulama menü yapısı. |
AccountSettingsService.ListBatch | Hesap başına UI ayarları (kimliği doğrulanmamış erişim dahil). |
UserService.GetCurrentUser / Update | Mevcut kullanıcı profili. |
ProductService | Hesap oluşturmak için ürünler ve para birimleri. |
CountryService.List | Ülke referansı. |
UploadService — GeneratePresignURL / ConfirmUpload / GetUpload | S3 presign ile avatar ve medya. |
Widget API
Tam istemci uygulamasına ihtiyaç duymadığınız durumlar için sadeleştirilmiş genel katman — liderlik tablosunu gösterin, master kartı render edin veya pazarlama sitenizden abonelik kodunu kontrol edin. Aynı protobuf sözleşmesi, daha az yüzey.
Yerleştirilmiş widget tarafından kullanılan herkese açık salt okunur alanların özeti — gerçek yöntem sayısı daha geniştir ve özel yerleştirmeler için istek üzerine ek okuma endpoint'leri açarız.
| Alan · Yöntemler | Purpose |
|---|---|
Accounts — Get, List, CheckSubscriptionCode | Master kartı, widget için liderlik tablosu listesi, abonelik kodu kontrolü. |
Profitability — ReturnsService.List, ChartService.Get / List | Sayfadaki mini grafikler ve getiriler. |
Statistics — StatService.GetTradingStatistics | Widget'taki başlık metrikleri. |
Positions — PositionService.List | Açık işlemler (herkese açık okuma). |
Fees — PlanService.GetActive, GetByPromoCode | Abonelik widget’ı için aktif plan. |
UI — CommonSettingsService.GetPlatformSettings | Widget içindeki markalama ve platform ayarları. |
Üç API yüzeyi de paylaşılan `.proto` dosyalarında (proto/b2copy/broker, /frontend, /widget) tanımlanır ve hem gRPC hem REST üzerinden sunulur — aynı sözleşmeden herhangi bir dil için istemci üretin. Yüzey başına tam metot listesi yukarıdaki örneklerden çok daha geniştir; eksiksiz referans API docs’tadır ve talep üzerine genişletilir.
Uygulamalı entegrasyon desteği
Yukarıda listelenen yöntemler yalnızca bir seçkidir — gerçek API çok daha geniştir ve CRM'inize, müşteri alanınıza ve raporlama modelinize uyacak şekilde istek üzerine genişletilir. Özel bir B2COPY mühendisi ilk sandbox çağrısından ilk canlı kopyaya kadar size eşlik eder; böylece broker, `.proto` dosyası ve iyi şanslar dileği yerine temiz, ihtiyaca uygun bir entegrasyon elde eder.
Bu sayfadaki tablolar API yüzeyinin temsili yaklaşık %30'unu listeler — çoğu brokerın ilk entegrasyonda kullandığı yöntemler. Tam proto sözleşmesi Broker, Frontend ve Widget genelinde çok daha büyüktür. İhtiyacınız olan yöntem sayfada yoksa, neredeyse kesinlikle zaten vardır — yoksa ekleriz.
Kickoff’tan go-live’a kadar atanır. Veri akışınızı inceler, senaryonuz için en temiz metot zincirlerini önerir ve sonraki entegrasyonlar için hazır kalır.
Listede olmayan bir yönteme mi ihtiyacınız var? Mevcut yanıta yeni bir alan mı? İç araç endpoint'i için toplu mod mu? Bir sonraki sürümde ekleriz — genellikle çeyrekler değil, günler içinde.
Örnek master'lar, yatırımcılar ve aboneliklerle tam kapsamlı bir hazırlık ortamı; ayrıca geliştirme sırasında hızlı iletişim için mühendislik ekibiyle özel Slack / Teams kanalı.
Üretime geçmeden önce endpoint'lerinizi, JWT kurulumunuzu, sayfalamayı ve hız yönetimini birlikte gözden geçiririz. Uç durumları destek taleplerine dönüşmeden yakalar.
CRM'iniz, müşteri portalınız ve raporlama modeliniz hakkında bilgi verin — entegrasyon yolunu belirleyip hangi yöntemlerin kullanılacağını (ve hangilerinin genişletileceğini) gösterelim.
Sıkça sorulan sorular
Hayır. Yukarıdaki tablolar, yöntemlerin temsili bir seçimini gösterir — çoğu brokerın ilk entegrasyonunda kullandığı bölümü. Gerçek API, üç yüzeyin tamamında (Broker / Frontend / Widget) önemli ölçüde daha geniştir. Eksiksiz ve güncel referans docs.b2copy.b2broker.com adresindeki API dokümanlarında yer alır.
Evet. İhtiyacınız olan yöntem, yanıt alanı, filtre veya toplu mod mevcut sözleşmede yoksa ekleriz. Onboard ettiğimiz neredeyse her broker, entegrasyon sırasında en az bir özel genişletme alır — tipik geri dönüş süresi çeyrekler değil, günler veya tek sürümdür. Kapsam belirleme sırasında senaryoyu bize bildirin; istemci kodu yazmadan önce sandbox'a eklenir.
Başlangıçtan yayına geçişe kadar özel bir B2COPY entegrasyon mühendisi, örnek master'lar / yatırımcılar / abonelikler içeren tam kapsamlı sandbox, hızlı iletişim için mühendislik ekibiyle özel Slack veya Teams kanalı ve yayına almadan önce endpoint'leriniz, JWT kurulumunuz ve sayfalamanız için ortak üretim öncesi inceleme alırsınız. Amaç, genel bir kopyala-yapıştır değil, altyapınıza uygun bir entegrasyondur.
Widget + SSO yolu için hayır. Bir back-office yöneticisi iframe kod parçasını kopyalayabilir ve JWT'leri yönetici panelinden imzalayabilir. Hazır CRM bağlayıcılarında (B2Core, Nullpoint, FXBO) bu, bir özellik anahtarıdır. Daha derin REST + gRPC entegrasyonları genellikle senaryo başına bir backend geliştiricisinin 1–3 gününü alır.
iframe widget'ını 30 dakikada — SSO ile aynı gün — entegre edin. Hazır CRM aktivasyonu (B2Core / Nullpoint / FX Back Office) da aynı gün tamamlanır. Tam özel REST + gRPC geliştirmeleri, sandbox ve özel B2COPY entegrasyon mühendisiyle uçtan uca 2–3 hafta sürer.
Evet. Her genel yöntem ortak .proto dosyalarında açıklanır (proto/b2copy/broker, .../frontend, .../widget). REST rotaları ve OpenAPI spesifikasyonu aynı dosyalardan oluşturulur — istek ve yanıt anlambilimi aynıdır, yalnızca altyapınıza uygun taşıma katmanını seçersiniz.
İki ayrı akış. Sunucudan sunucuya: EC anahtarınızla imzalanmış, kiracı bazında kapsamlandırılmış yönetici JWT; Broker API'ye karşı kullanılır. Kullanıcı oturumu: müşteri portalınızdan harici JWT oluşturun, SideAuthenticate (veya AuthUserWithExternalToken) üzerinden değiştirin, ardından Frontend API'yi kullanıcı kapsamlı çağırın. Her iki tarafta da parola işleme yoktur.
150+ admin paneli ayarı, geliştirme gerekmeden B2COPY’nin büyük kısmını kapsar: liderlik tablosu sütunları, istatistik görünürlüğü, altı ücret türü ve formülleri, master’lar için broker kontrollü risk limitleri, hesap görünürlüğü varsayılanları, sembol eşleme ve tam özel markalama (renkler, logolar, temalar).
Explore more
Performans, yönetim, abonelik, hacim, katılım ve kâr ücretleri.
Daha fazla bilgiGünlük limitler, maksimum düşüş kontrolleri ve kişisel zarar limitleri.
Daha fazla bilgiAltı tahsis yöntemi — oransal, oran çarpanı veya sabit lot.
Daha fazla bilgiMT4, MT5, cTrader ve B2Trader sunucuları arasında işlemleri kopyalayın.
Daha fazla bilgiWidget SSO, CRM entegrasyonları, REST ve gRPC API'leri.
Daha fazla bilgiCRM'inizi, müşteri alanınızı ve back office'inizi inceleyerek mühendislik derinliğinize uyan entegrasyon yolunu öneririz — bugün widget, üç hafta içinde tam API.
