KMTP API TEST ve SERTİFİKASYON İŞLEMLERİ 1 / 8
A.Ş. nin KMTP API SERTİFİKASYON TESTİ Üyelerimizin Dikkatine: Nisan 2014-v1.0 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
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. 2. Login servisini (K.D 7.1) kullanıcı adı ve şifreniz ile çağırarak oturum anahtarı aldığınızı kontrol edin. 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. 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. 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 Metal Stok Fiyat Valör Alış teklifi Altın Standart işlem Normal emir Külçe 1kg, 995 ayar külçe 1200 USD/ONS T1 ( ) Emir beklenen etkiyi yarattı ( ) Emir beklenmeyen bir etki yarattı 3 / 8
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. 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. 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 Metal Stok Fiyat Valör Satış teklifi Altın Standart işlem Normal emir Külçe 1kg, 995 ayar külçe 1201 USD/ONS T1 ( ) Emir beklenen etkiyi yarattı ( ) 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. 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. 4 / 8
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 Metal Stok Fiyat Valör Alış teklifi Altın Standart işlem Normal emir Külçe 1kg, 995 ayar külçe 1201 USD/ONS T1 ( ) Emir beklenen etkiyi yarattı ( ) 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. 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. 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. 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 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. 5 / 8
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. 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. 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. 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. 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. # Teklif Metal Kodu İşlem Metal Teklif Fiyat Miktar Valör Id Ayar Örnek 1 K AU 1 1 1 1200 100 1 995 Örnek 2 A AB 1 1 1 1200 100 1 995 Örnek 3 A AU 9 1 1 1200 100 1 995 Örnek 4 A AU 1 9 1 1200 100 1 995 Örnek 5 A AU 1 1 9 1200 100 1 995 Örnek 6 A AU 1 1 1 1200 100 1000 995 6 / 8
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 Metal Kodu İşlem Metal Teklif Fiyat Miktar Valör Id Örnek 1 A AU 1 1 1 100 100 1 995 Örnek 3 S AU 1 1 1 100 100 1 995 Ayar 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. 22. Logout servisini (K.D. 7.2) çağırarak oturumunuzu sonlandırın. { "mesaj":"oturum kapatıldı" } cevabı aldığınızı kontrol edin. 7 / 8
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