170 likes | 476 Views
TÜRKİYE ELEKTRONİK FON ALIM SATIM PLATFORMU WEB SERVİS İŞLEMLERİ. Genel Bilgiler Güvenlik İşlemleri Geliştirme Test Üretim Kullanılacak Öncelikli Web Servisleri TEFASWebServisOperParam.xlsx Dokümanı Fon Alımı Web Servis Örneği. Gündem.
E N D
TÜRKİYE ELEKTRONİK FON ALIM SATIM PLATFORMU WEB SERVİS İŞLEMLERİ
Genel Bilgiler Güvenlik İşlemleri Geliştirme Test Üretim Kullanılacak Öncelikli Web Servisleri TEFASWebServisOperParam.xlsx Dokümanı Fon Alımı Web Servis Örneği Gündem
TEFASP projesinin işlemleri projenin kendi ekranları(client) aracılığı ile yapılabileceği gibi ek olarak Web Servis kullanılarak da yapılabilir. • TEFASP projesinin Web Servisleri 2 kategoriye ayrılmıştır. • Öncelikli Web Servisler • Diğer Web Servisler (Opsiyonel) • Takasbank web servis sağlayıcı, üyeler istemci olacaktır. • Üyeler kendi ekranları ile Takasbank’ın sağladığı Web Servis arayüzünün entegrasyonu sağlayacaklardır. • Web servisler Request/Response modeline göre çalışacaktır. • İletişim yöntemi senkron olarak tanımlanmıştır. • İstemci tarafında kullanılan teknolojiye göre servisi asenkron olarak kullanabilir. Genel
Her bir operasyon kendi içinde atomik transactiona sahiptir. Oparasyonlar arası veya istemci sunucu arası transaction yönetimi bulunmamaktadır. Web Servilerine erişim Takasbank Intranet ağı üzerinden olacaktır. Web servis veri iletişim protokolü HTTP olacaktır. HTTPS (SSL) kullanılacaktır Web servis mesaj formatı SOAP (Simple Object Acces Protocol) olacaktır. SOAP mesajının veri tipi document olacaktır. SOAP mesajları attachment içermeyecektir. Web Servis Server implemantasyonu Java JAX-WS library’leri ile yapılmıştır. Client (Aracı Kurum) tarafında Java veya .Net kullanılabilir. Genel - devam
Web servis mimarisi Aracı Kurum İnternet/ Intranet Client Takasbank Aracı Kurum Web Uygulama Sunucu Client Ekr-1 Takasbank Web Sunucusu Takasbank Web Servis API Client Ekr-2 SOAP Message Web Uygulaması . . . Takasbank Web Servis Sunucusu Client Ekr-N
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
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, "ATA90"); requestContext.put(BindingProvider.PASSWORD_PROPERTY, "TestSifre"); try { BakiyeResponse response= port.getHavuzBakiye("AAK1"); List<BigDecimal> havuzBakList= response.getResultList(); for (BigDecimal havuzBak : havuzBakList) { System.out.println("havuzBak:"+havuzBak); } } catch (Exception_Exception e) { e.printStackTrace(); } } DOĞRULAMA(bir java istemci örneği) Kullanıcı ve şifre
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 <?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> DOĞRULAMA (HTTP Request Örneği) ATA990:Test123’ün base64 Encoded halidir
HTTP-RERESPONSE Mesajı Header: HTTP/1.1 200 OK Size: 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> Authentication(HTTP Response Örneği)
Web sevis sunucu programlarının yazılım süreci tamamlanmıştır. • Web servis istemci programının yazılımları üyeler tarafından yerine getirilecektir. • İstemci geliştirme ortamları için için Java veya .NET platformlarından biri kullanılabilir. • Geliştirme işlemine yardımcı olması açısından aşağıdaki adreslere yadımcı dökümalar konulmuştur. • Takasbank internet sitesi->Üyelik İşlemleri->Özel İşlemler->Web Servis Hizmetleri • FplWS.wsdl • FplWS.xsd • Takasbank internet sitesi->Üyelik İşlemleri->Özel İşlemler->Tefasp İşlemleri • TEFASP Web Servis Tanitim.pptx • TEFASWebServisOperParam.xlsx GELİŞTİRME
Üyeler, kendi taraflarında web servis istemci yazılımlarını tamamladıklarında testlerini Takasbank’ın kendilerine sağladığı test ortamında gerçekleştirebilirler Üyeler testleri Takasbank intranet ağı üzerinden yapacaktır. Test ortamına bağlantı linki, kullanıcı ve şifreler, teste hazır olan üyelere iletilecektir. Test
C:\Windows\System32\drivers\etc\hosts dosyasınaeklenir 192.168.98.23 takaswebtest.takasdom.takasbank.com.tr 192.168.98.20takasweb.takasdom.takasbank.com.tr • WSDL dökümanınaerişim adresi aşağıdadır 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 Test OrtamIna BağlantI
Testlerini başarıyla tamamlayan üyeler üretim ortamına geçebilir. Üretim ortamının bağlantı adresi(URL’i), kullanıcı ve şifreler üretim ortamına geçiş aşamasında üyelere bildirilir. ÜRETİM
Alım-Satım Talimat İşlemleri • insertAlSatGecici • insertAlSat (kullanıcı onayı istenirse) • deleteAlSatGecici • Talimat İzleme – İptal • listTalimat • cancelTalimat • updateTalimat • Temel Fon Bilgileri • listFonKisit • listKisitBildirRap • fonDetay ÖNCELİKLİ WEB SERVİSLER
İşlemler • Havuz Talimat İşlemleri • Nakit Borç Kapatma • Gelen Talimat İzleme • Komisyon Bilgileri İzleme- Ödeme • Bildirimler • Fon Fiyat Bildirimi • Raporlar • Komisyon Ödemeleri Takip Raporu • Gerçekleşen İşlemler Raporu • Fon Özlük Bilgileri Raporu • Fon Analiz Raporları dİğer WEB ServİsLER
Fon AlIm/SatIm İşlemİ Örneğİ Aracı Kurum Takasbank İntranet Takasbank Takasbank Web Sunucusu Takasbank Uygulama Sunucusu Fon Alım Talimatı Giriş Ekranı SOAP/XML Message insertAlSatGecici çağrılır E ok? Fon Alım Onay Ekranı H Bitti SOAP/XML Message insertAlSatçağrılır 10:Talimat Onaylanmıştır 15:İşlem gerçekleştirilmek üzere MKK ya gönderildi 20:Kıymet blokajı için MKK ya mesaj gönderildi