web servİs teknİk sunum
DESCRIPTION
TÜRKİYE ELEKTRONİK FON DAĞITIM PLATFORMU (TEFAS). WEB SERVİS TEKNİK SUNUM. GÜNDEM. Web Servis Bilgileri Genel Özellikler Bağlantı Şekli ve Kuralları Web Servis İsimleri ve Dökümanları. GENEL BİLGİLER. TEFAS işlemleri 3 yöntem kullanılarak yapılabilir. TAKASBANK ekranları - PowerPoint PPT PresentationTRANSCRIPT
WEB SERVİS TEKNİK SUNUM
TÜRKİYE ELEKTRONİK FON DAĞITIM PLATFORMU
(TEFAS)
GÜNDEM
Web Servis BilgileriGenel ÖzelliklerBağlantı Şekli ve KurallarıWeb Servis İsimleri ve Dökümanları
GENEL BİLGİLER
TEFAS işlemleri 3 yöntem kullanılarak yapılabilir.
TAKASBANK ekranlarıWeb Servisler (19 tane)BIST ExAPI terminalleri üzerinden (4 tane)
insertAlSatIMKB
cancelTalimatIMKB
listTalimatIMKB
listFonKisitIMKB
WEB SERVİS GENEL ÖZELLİKLERİ
Web Servislere erişim Takasbank Intranet ağı üzerinden olacaktır.
Takasbank web servis sağlayıcısı, üyeler istemci olacaktır.
(Request/Response )
Web servis veri iletişim protokolü HTTPS (SSL) , mesaj formatı SOAP
(Simple Object Acces Protocol) dır.
WEB SERVİS MİMARİSİ
İnternet
Şube
Client -N
.
.
.
İSTEMCİLER TAKASBANK
İstemci Uygulama Sunucusu
SOAPMesaj
Takasbank Uygulama Sunucusu
TakasbankServis
Sunucusu
Intranet
DOĞRULAMA
Doğrulama yöntemi olarak HTTP simple
authentication kullanılacaktır
Kullanıcı olarak kurumsal kullanıcılar
(ATA990,GLB990 vb.) kullanılacaktır
Şifreler kurumsal kullanıcı şifreleri olacaktır
Kullanıcı/Şifre bilgileri HTTP paketinin Header
kısmında gönderilecektir
DOĞRULAMA( Java İstemci Örneği)
public static void main(String[] args) {
FplWebServiceImplService service = new FplWebServiceImplService();FplWebService port=service.getFplWebServicePort();
Map<String, Object> requestContext = ((BindingProvider)port).getRequestContext(); requestContext.put(BindingProvider.USERNAME_PROPERTY, "ATA990"); requestContext.put(BindingProvider.PASSWORD_PROPERTY, "Test123");
try {BakiyeResponse response= port.getHavuzBakiye("AAK");List<BigDecimal> havuzBakList= response.getResultList();for (BigDecimal havuzBak : havuzBakList) {
System.out.println("havuzBak:"+havuzBak);}
} catch (Exception_Exception e) {e.printStackTrace();
}
}
Kullanıcı ve şifre
DOĞRULAMA (HTTP Request Örneği)
HTTP-REQUEST Mesajı
Header: POST/com.takasbank.tvs.fpl.uyews/fplWS HTTP/1.1accept:text/xml, multipart/related, text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2authorization:Basic QVRBOTkwOlRlc3QxMjM=content-type:text/xml; charset=utf-8connection:keep-alivecontent-length:253
<?xml version="1.0" encoding="UTF-8" standalone="no"?><S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Body><ns2:getHavuzBakiye xmlns:ns2="http://webservice.uyews.fpl.tvs.takasbank.com/">
<fonKod>AAK</fonKod></ns2:getHavuzBakiye>
</S:Body></S:Envelope>
ATA990:Test123’ün base64 Encoded halidir
Authentication (HTTP Response Örneği)
HTTP-RESPONSE Mesajı
Header: HTTP/1.1 200 OKSize: 300 (461) bytes
<?xml version="1.0" encoding="UTF-8" standalone="no"?><S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Body><ns2:getHavuzBakiyeResponse
xmlns:ns2="http://webservice.uyews.fpl.tvs.takasbank.com/"><return>
<resultList>970461.000</resultList></return>
</ns2:getHavuzBakiyeResponse></S:Body>
</S:Envelope>
GELİŞTİRME
Web servis sunucu programlarının yazılım süreci tamamlanmıştır. Web servis istemci programlarının yazılımları üyeler tarafından hazırlanacaktır. Geliştirme işlemine yardımcı olması açısından aşağıdaki adrese yardımcı dökümanlar konulmuştur.
http://www.takasbank.com.tr/tr/Sayfalar/TEFAS.aspxFplWS.wsdlFplWS.xsdTEFASP Web Servis Tanitim.pptxTEFASWebServisOperParamUye.xlsx
TESTÜyeler testlerini Takasbank intranet ağı üzerinden yapacaktırC:\Windows\System32\drivers\etc\hosts dosyasına aşağıdaki satır eklenmelidir
Test:192.168.98.23 takaswebtest.takasdom.takasbank.com.trGerçek Ortam:192.168.98.20 takasweb.takasdom.takasbank.com.tr
Test ortamına bağlantı için kullanıcı ve şifreler, teste hazır olan üyelere iletilecektir.Üretim ortamına geçiş sırasında kurumsal kullanıcı ve şifre bilgileri üye işlerine talep yapılarak alınacaktır.
Web Servis test için URL; https://takaswebtest.takasdom.takasbank.com.tr:2550/com.takasbank.tvs.fpl.uyews/fplWS?wsdl https://takaswebtest.takasdom.takasbank.com.tr:2550/com.takasbank.tvs.fpl.uyews/fplWS?xsd=1
TAKASBANK test ekranları için URL; https://takaswebtest.takasdom.takasbank.com.tr:2550/com.takasbank.login.uyeweb/
WEB SERVİSLERTüm web servislerin parametre ve açıklamalarını gösteren dokumana http://www.takasbank.com.tr/tr/Sayfalar/TEFAS.aspx adresinde ‘Web Servis Açıklama Bilgileri’ linkinden ulaşılabilir.
Talimat İşlemleriinsertAlSatTalimat => Talimat girişicancelTalimat => Talimat iptalilistAlSatTalRap => Talimatların listelenmesi insertTalepGiris => Saklamacısı farklı olan üyenin talimat girişiacceptTalep => Saklamacı talimat onayırefuseTalepToplu => Saklamacı talimat iptaliraporTalep => Saklamacısı farklı olan üyenin talimatlarını listelemelistTakasBorcIzle => Net/Bürüt Nakit Borç/Alacak ListelelistGelenTalIzle => Kurucu/Operatör kendine gelen talimatları listelemelistGercIslRap => Gerçekleşen talimatları listeleme
WEB SERVİSLER
Bildirim İşlemleriupdateFiyatBildir – Platforma fon fiyat bildirimi Giriş/Güncelleme listFiyatBildirRap – Platformdaki fon fiyatlarını listelemeinsertHavuzTalimatGiris – Kurucu/Operatör fon Havuz Arttırma/AzaltmagetHavuzBakiye -- Platformdaki fon sayısıupdateKisitBildir – Platforma fon bilgileri bildirimi Giriş/Güncelleme listKisitBildirRap – Platformdaki fon bilgileri listeleme
Yardımcı ServislerlistKursatUyeRap – Platforma tanımlı fonları ve işlemci üyelerini listelerlistTefaspFonRap – Platforma tanımlı fonları ve kurucu bilgilerini listelerlistTefaspUyeRap – Platforma tanımlı üyeleri listeler
TeşekkürlerOperasyon
Fatma Kö[email protected]
+(90) 212 315 21 83
Analist Özgür Tunalı
[email protected] +(90) 212 315 20 90
Yazılım Nalan Keskin
[email protected]+(90) 212 315 21 38