İndir - Borsa İstanbul

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