Download
1 / 14
200 likes | 810 Views
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ı
E N D
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ı • 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İ İSTEMCİLER TAKASBANK İnternet Takasbank Uygulama Sunucusu İstemci Uygulama Sunucusu Şube Intranet SOAP Mesaj . . . TakasbankServis Sunucusu Client -N
DOĞRULAMA • Doğrulama yöntemi olarak HTTP simpleauthenticationkullanı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) publicstaticvoid main(String[] args) { FplWebServiceImplService service = newFplWebServiceImplService(); FplWebService port=service.getFplWebServicePort(); Map<String, Object> requestContext = ((BindingProvider)port).getRequestContext(); requestContext.put(BindingProvider.USERNAME_PROPERTY, "ATA990"); requestContext.put(BindingProvider.PASSWORD_PROPERTY, "Test123"); try { BakiyeResponseresponse= port.getHavuzBakiye("AAK"); List<BigDecimal> havuzBakList= response.getResultList(); for (BigDecimalhavuzBak : 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.1 accept:text/xml, multipart/related, text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2 authorization:Basic QVRBOTkwOlRlc3QxMjM= content-type:text/xml; charset=utf-8 connection:keep-alive content-length:253 <?xmlversion="1.0" encoding="UTF-8" standalone="no"?> <S:Envelopexmlns:S="http://schemas.xmlsoap.org/soap/envelope/"> <S:Body> <ns2:getHavuzBakiyexmlns: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 OK Size: 300 (461) bytes <?xmlversion="1.0" encoding="UTF-8" standalone="no"?> <S:Envelopexmlns: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ümanlarkonulmuştur. http://www.takasbank.com.tr/tr/Sayfalar/TEFAS.aspx FplWS.wsdl FplWS.xsd TEFASP Web Servis Tanitim.pptx TEFASWebServisOperParamUye.xlsx
TEST • Üyeler testlerini Takasbank intranet ağı üzerinden yapacaktır • C:\Windows\System32\drivers\etc\hosts dosyasınaaşağıdaki satır eklenmelidir Test: 192.168.98.23 takaswebtest.takasdom.takasbank.com.tr Gerçek Ortam: 192.168.98.20takasweb.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İSLER Tü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 İşlemleri • insertAlSatTalimat => Talimat girişi • cancelTalimat =>Talimat iptali • listAlSatTalRap => Talimatların listelenmesi • insertTalepGiris =>Saklamacısı farklı olan üyenin talimat girişi • acceptTalep =>Saklamacı talimat onayı • refuseTalepToplu =>Saklamacı talimat iptali • raporTalep =>Saklamacısı farklı olan üyenin talimatlarını listeleme • listTakasBorcIzle => Net/Bürüt Nakit Borç/Alacak Listele • listGelenTalIzle =>Kurucu/Operatör kendine gelen talimatları listeleme • listGercIslRap =>Gerçekleşen talimatları listeleme
WEB SERVİSLER • Bildirim İşlemleri • updateFiyatBildir – Platforma fon fiyat bildirimi Giriş/Güncelleme • listFiyatBildirRap – Platformdaki fon fiyatlarını listeleme • insertHavuzTalimatGiris – Kurucu/Operatör fon Havuz Arttırma/Azaltma • getHavuzBakiye -- Platformdaki fon sayısı • updateKisitBildir – Platforma fon bilgileri bildirimi Giriş/Güncelleme • listKisitBildirRap – Platformdaki fon bilgileri listeleme • Yardımcı Servisler • listKursatUyeRap – Platforma tanımlı fonları ve işlemci üyelerini listeler • listTefaspFonRap – Platforma tanımlı fonları ve kurucu bilgilerini listeler • listTefaspUyeRap – Platforma tanımlı üyeleri listeler
Teşekkürler Analist Özgür Tunalı otunali@takasbank.com.tr +(90) 212 315 20 90 Operasyon Fatma Köksal fkoksal@takasbank.com.tr +(90) 212 315 21 83 Yazılım Nalan Keskin nbaydan@takasbank.com.tr +(90) 212 315 21 38
