Nisan 2014-v1.0 KMTP API TEST ve SERTİFİKASYON İŞLEMLERİ 1/8 Nisan 2014-v1.0 ………………………………… A.Ş.’ nin KMTP API SERTİFİKASYON TESTİ Üyelerimizin Dikkatine: Bu doküman, üyelerimizin Kıymetli Madenler ve Kıymetli Taşlar Piyasası sistemi üzerinde işlemlerini sağlıklı bir şekilde gerçekleştirebilmeleri amacıyla uygulanacak sertifikasyon testlerini içermektedir. Sertifikasyon testleri, bağlantı ve fonksiyonel testler olmak üzere iki ana kısımdan oluşmaktadır. Sertifikasyon testlerine başlayabilmek için üyelerimiz, Borsa İstanbul A.Ş. BTdestek masasına başvuruda bulunacaklardır. Başvuru sonrasında kendilerine verilecek kullanıcı adı ve şifre bilgilerini alan üyelerimiz, aşağıdaki verilen URL adresinden sisteme bağlanabileceklerdir. https://ebstest.borsaistanbul.com/EBS/api/ Üye sistemi üzerinde gerçekleştirilecek her türlü entegrasyon yazılım faaliyeti ve bu geliştirmelerden kaynaklanacak hatalar üyelerimizin sorumluluğundadır. Sertifikasyon işlemlerine başlamadan önce, aşağıda linki verilen dokumanı inceleyiniz. http://www.borsaistanbul.com/uyeozel/SoftwareAndDocuments/kmtp Bu doküman testlerde gerçekleştirilecek adımların detaylarını içermektedir. Örneğin : (K.D. 7.4) ifadesi “Kurallar Dokumanı” 7.4 başlığında yer alan “Sistem Kontrolü” başlığına tekabül etmektedir. Beklenmeyen bir durum olması halinde Borsa İstanbul A.Ş. BT-destek masasına başvurunuz. Testin son bölümünde yer alan doldurduktan sonra Borsa İstanbul yetkililerine ulaştırınız. 2/8 Nisan 2014-v1.0 1. Bağlantı Testleri (K.D. Kurallar Dokumanını ifade etmektedir.) 1. Sistem kontrol servisini (K.D. 7.4) çağırın. { "mesaj":"Bağlantı başarılı" } cevabının alındığını kontrol edin. ( ) Beklenen mesajlar alındı ( ) Mesajlarda sorun var 2. Login servisini (K.D 7.1) kullanıcı adı ve şifreniz ile çağırarak oturum anahtarı aldığınızı kontrol edin. ( ) Beklenen mesajlar alındı ( ) Mesajlarda sorun var 2. Fonksiyonel Testler 1. Teklif verme kuralları sorgulama servisini (K.D. 7.6) çağırın. Gelen cevapta; 4 adet metal kodunun (AU, AG, PD, PL) bulunduğunu Altın->Standart İşlem->Normal Emir bilgilerinin hiyerarşik olarak içerildiğini ve Normal Emir içerisinde Külçe Metaltipi içerisinde Id=1, Ağırlık=1, Ayar=995 özelliklerine ait metal stok bilgisi olduğunu kontrol edin. ( ) Beklenen mesajlar alındı ( ) Mesajlarda sorun var 2. Bilgi Güncellik Sorgulama servisini (K.D. 7.3) çağırarak “SD” değerinin “true”, diğer değerlerin sıfırdan farklı olduğunu kontrol edin. ( ) Beklenen mesajlar alındı ( ) Mesajlarda sorun var 3. Teklif Gönder servisini (K.D. 7.7) çağırarak aşağıda verilen özelliklere sahip bir teklifi, birinci adımda alınan kurallar doğrultusunda gönderin. Teklif Id bilgisi döndüğünü görün. Teklif Özellikleri Teklif türü Metal Kodu İşlem Türü Emir Türü Metal Tipi Metal Stok Fiyat Valör ( ) Beklenen mesajlar alındı ( ) Emir beklenen etkiyi yarattı Alış teklifi Altın Standart işlem Normal emir Külçe 1kg, 995 ayar külçe 1200 USD/ONS T1 ( ) Mesajlarda sorun var ( ) Emir beklenmeyen bir etki yarattı 3/8 Nisan 2014-v1.0 4. Bilgi Güncellik Sorgulama servisini (K.D. 7.3) servisini çağırarak “ATK” değerinin 2. Adımda alınan değerden farklı olduğunu kontrol edin. ( ) Beklenen mesajlar alındı ( ) Mesajlarda sorun var 5. Alış Teklifleri Sorgulama servisini (K.D. 7.10) çağırarak bekleyen teklifler listesini alın, 3. adımda aldığınız teklfiId bilgisinin gelen listede yer aldığını kontrol edin. ( ) Beklenen mesajlar alındı ( ) Mesajlarda sorun var 6. Teklif Gönder servisini (K.D. 7.7) çağırarak aşağıda verilen özelliklere sahip bir teklifi, birinci adımda alınan kurallar doğrultusunda gönderin. Teklif Id bilgisi döndüğünü görün. Teklif Özellikleri Teklif türü Metal Kodu İşlem Türü Emir Türü Metal Tipi Metal Stok Fiyat Valör ( ) Beklenen mesajlar alındı ( ) Emir beklenen etkiyi yarattı Satış teklifi Altın Standart işlem Normal emir Külçe 1kg, 995 ayar külçe 1201 USD/ONS T1 ( ) Mesajlarda sorun var ( ) Emir beklenmeyen bir etki yarattı 7. Bilgi Güncellik Sorgulama servisini (K.D. 7.3) servisini çağırarak “STK” değerinin 2. Adımda alınan değerden farklı olduğunu kontrol edin. ( ) Beklenen mesajlar alındı ( ) Mesajlarda sorun var 8. Satış Teklifleri Sorgulama servisini (K.D. 7.11) çağırarak bekleyen teklifler listesini alın, 6. adımda aldığınız teklfiId bilgisinin gelen listede yer aldığını kontrol edin. ( ) Beklenen mesajlar alındı ( ) Mesajlarda sorun var 4/8 Nisan 2014-v1.0 9. Teklif Gönder servisini (K.D. 7.7) çağırarak aşağıda verilen özelliklere sahip bir teklifi, birinci adımda alınan kurallar doğrultusunda gönderin. Teklif Id bilgisi döndüğünü görün. Teklif Özellikleri Teklif türü Metal Kodu İşlem Türü Emir Türü Metal Tipi Metal Stok Fiyat Valör ( ) Beklenen mesajlar alındı ( ) Emir beklenen etkiyi yarattı Alış teklifi Altın Standart işlem Normal emir Külçe 1kg, 995 ayar külçe 1201 USD/ONS T1 ( ) Mesajlarda sorun var ( ) Emir beklenmeyen bir etki yarattı 10. Bilgi Güncellik Sorgulama servisini (K.D. 7.3) çağırarak “IK” değerinin 2. adımda alınan değerden farklı olduğunu kontrol edin. ( ) Beklenen mesajlar alındı ( ) Mesajlarda sorun var 11. İşlemleri Sorgulama servisini (K.D. 7.12) çağırarak sistemde yer alan işlem listesini alın. 6. ve 9. adımlarda kaydedilen teklif bilgilerine ait işlemin gelen listede yer aldığını kontrol edin. ( ) Beklenen mesajlar alındı ( ) Mesajlarda sorun var 12. Yetki Sorgulama servisini (K.D. 7.13) “Altın” için çağırarak sıfırdan farklı bir miktar bilgisi aldığınızı kontrol edin. ( ) Beklenen mesajlar alındı ( ) Mesajlarda sorun var 13. “Teklif Güncelle” servisini kullanarak 3. adımda kaydettiğiniz teklifi aşağıdaki şekilde güncelleyiniz. {"mesaj":"Teklif başarıyla güncellendi" } cevabı aldığınızı kontrol ediniz. Fiyat : 1201 USD/ONS , Miktar : 2 ( ) Beklenen mesajlar alındı ( ) Mesajlarda sorun var 14. Bilgi Güncellik Sorgulama servisini (K.D. 7.3) çağırarak “ATK” değerinin 10. adımda alınan değerden farklı olduğunu kontrol edin. ( ) Beklenen mesajlar alındı ( ) Mesajlarda sorun var 5/8 Nisan 2014-v1.0 15. 13. adımda güncellediğiniz teklifi Teklif İptal servisi (K.D. 7.9) ile iptal ediniz. {"mesaj":"Teklif iptal edildi."} mesajı aldığınızı kontrol ediniz. ( ) Beklenen mesajlar alındı ( ) Mesajlarda sorun var 16. Alış Teklifleri Sorgulama servisini (K.D. 7.10) çağırarak 15.adım iptal ettiğiniz teklifin cevap içinde yer almadığını kontrol edin. ( ) Beklenen mesajlar alındı ( ) Mesajlarda sorun var 17. Kasa Sorgulama servisini (K.D. 7.14) kullanarak kasanızda o an duran altın metallerin listesini sorgulayın. Kasa listesini aldığınızı kontrol edin. ( ) Beklenen mesajlar alındı ( ) Mesajlarda sorun var 18. Müşteri listesi sorgulama servisini (K.D. 7.15) kullanarak kayıtlı müşterilerinizin listesini sorgulayın. Müşteri listesini aldığınızı kontrol edin. ( ) Beklenen mesajlar alındı ( ) Mesajlarda sorun var 19. Teklif gönderirken kullanılacak parametreler “teklif kuralları servisi” üzerinden alınan hiyerarşik yapıya uygun olmalıdır. Bu yapıya uygun olmayan teklif için sisteminizden KMTP API ye çağrı çıkmamalıdır. Aşağıdaki örnek teklif bilgilerini kullanarak teklif oluşturulamadığını veya teklif gönderilemediğini kontrol edin. # Örnek 1 Örnek 2 Örnek 3 Örnek 4 Örnek 5 Örnek 6 Teklif Tipi K A A A A A Metal Kodu AU AB AU AU AU AU İşlem Tipi 1 1 9 1 1 1 ( ) Beklenen mesajlar alındı Metal Tipi 1 1 1 9 1 1 Teklif Tipi 1 1 1 1 9 1 Fiyat Miktar Valör Id Ayar 1200 1200 1200 1200 1200 1200 100 100 100 100 100 100 1 1 1 1 1 1000 995 995 995 995 995 995 ( ) Mesajlarda sorun var 6/8 Nisan 2014-v1.0 20. Aşağıda yer alan bilgileri ile teklif kaydet servisini kullanarak iki adet teklif kaydetmeye çalışın. http BAD_REQUEST cevabı alarak başarısız olduğunuzu kontrol edin. Teklif Tipi Örnek 1 A Örnek 3 S Metal Kodu İşlem Tipi AU AU 1 1 ( ) Beklenen mesajlar alındı Metal Tipi 1 1 Teklif Tipi Fiyat Miktar 1 1 100 100 100 100 Valör Id 1 1 Ayar 995 995 ( ) Mesajlarda sorun var 21. Duyuruları sorgulama servisini kullanarak (K.D. 7.5) sistemde yer alan son 3 duyuruyu sorgulayın. 3 adet duyuru içeren listeyi aldığınızı kontrol edin. ( ) Beklenen mesajlar alındı ( ) Mesajlarda sorun var 22. Logout servisini (K.D. 7.2) çağırarak oturumunuzu sonlandırın. { "mesaj":"Oturum kapatıldı" } cevabı aldığınızı kontrol edin. ( ) Beklenen mesajlar alındı ( ) Mesajlarda sorun var 7/8 Nisan 2014-v1.0 3 Test Hakkındaki Görüşleriniz: Aracı Kurum Ünvanı Teste Katılan Teknik Yetkili Teste Katılan Piyasa Yetkilisi Teste Katılan Borsa Yetkilisi Genel Değerlendirme (Bu bölüm Borsa İstanbul yetkililerince doldurulacaktır.) 8/8
© Copyright 2024 Paperzz