TÜRKİYE ELEKTRONİK FON ALIM SATIM PLATFORMU WEB SERVİS İŞLEMLERİ

Transkript

1 TÜRKİYE ELEKTRONİK FON ALIM SATIM PLATFORMU WEB SERVİS İŞLEMLERİ 1

2 GÜNDEM 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 2

3 GENEL 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. 3

4 GENEL - DEVAM 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. 4

5 WEB SERVIS MIMARISI Aracı Kurum İnternet/ Intranet Client Aracı Kurum Web Uygulama Sunucu Takasbank Client Ekr-1 Client Ekr-2 Web Uygulaması Takasbank Web Servis API SOAP Message Takasbank Web Sunucusu... Client Ekr-N Takasbank Web Servis Sunucusu 5

6 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. 6

7 DOĞRULAMA(BIR JAVA ISTEMCI ÖRNEĞI) public static void main(string[] args) { FplWebServiceImplService service = new FplWebServiceImplService(); FplWebService port=service.getfplwebserviceport(); Kullanıcı ve şifre 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(); } } 7

8 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 <?xml version="1.0" encoding="utf-8" standalone="no"?> <S:Envelope xmlns:s=" <S:Body> <ns2:gethavuzbakiye xmlns:ns2=" <fonkod>aak</fonkod> </ns2:gethavuzbakiye> </S:Body> </S:Envelope> ATA990:Test123 ün base64 Encoded halidir 8

9 AUTHENTICATION(HTTP RESPONSE ÖRNEĞI) HTTP-RERESPONSE Mesajı Header: HTTP/ OK Size: 300 (461) bytes <?xml version="1.0" encoding="utf-8" standalone="no"?> <S:Envelope xmlns:s=" <S:Body> <ns2:gethavuzbakiyeresponse xmlns:ns2=" <return> <resultlist> </resultlist> </return> </ns2:gethavuzbakiyeresponse> </S:Body> </S:Envelope> 9

10 GELİŞTİRME 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 10

11 TEST Ü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. 11

12 TEST ORTAMINA BAĞLANTI C:\Windows\System32\drivers\etc\hosts dosyasına eklenir takaswebtest.takasdom.takasbank.com.tr takasweb.takasdom.takasbank.com.tr WSDL dökümanına erişim adresi aşağıdadır

13 ÜRETİM 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. 13

14 ÖNCELİKLİ WEB SERVİSLER 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 14

15 DİĞER 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ı 15

16 TEFASWEBSERVISOPERPARAM.XLSX DOKÜMANI Operasyon Adı Operasyon Açıklaması inserthavuztalimatgiris Havuz bakiyesini artırıp/azaltma talimat girişi yapılır. Giriş Parametreleri Parametre Adı Veri Tipi Açıklama uyekod char(3) Operatör Üye islemtip char(1) A: Havuz Artırım, E: Havuz Eksiltim fonkod char(3) Fon Kodu islemadet decimal(20,3) İşlem Adet Çıkış Parametreleri Parametre Adı Veri Tipi Açıklama ret Integer 10: işlem tamam 16

17 FON ALIM/SATIM İŞLEMİ ÖRNEĞİ Aracı Kurum Takasbank İntranet Takasbank Fon Alım Talimatı Giriş Ekranı Fon Alım Onay Ekranı E insertalsatgecici çağrılır ok? Bitti H insertalsat çağrılır SOAP/XML Message SOAP/XML Message Takasbank Web Sunucusu Takasbank Uygulama Sunucusu 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