1 BISTECH VERDA HTTP-REST API Entegrasyon Dokümanı HTTP REST v1.05
2 İçindekiler Doküman Tarihçesi...2 I. Giriş...3 II. Verda API uygulamasına nasıl bağlanabilirim?...3 a. VERDA API Erişim Adresleri... 3 b. VERDA API Kullanıcısı talep süreci... 4 i. Canlı Ortam için kullanıcı talebi... 4 ii. Test Ortamı için kullanıcı talebi... 4 III. Verda API Kullanım Detayları...4 a. KİMLİK DOĞRULAMA... 4 i. Kimlik doğrulama sebebiyle oluşabilecek hata mesajları ve anlamları:... 4 ii. Örnek: Kimlik doğrulama için örnek bir mesaj:... 5 b. ŞİFRE DEĞİŞTİRME... 5 i. Örnek: Şifre Değiştirme... 6 c. DOSYA TİPLERİNİ LİSTELEME... 6 i. Örnek: Dosya Tiplerinin Listelenmesi:... 8 d. DOSYA İNDİRME... 9 i. Örnek: Verileri dosya formatında indirme:... 10 ii. Örnek: Verileri JSON formatında indirme:... 11 IV. Verda hakkında nasıl destek alabilirim?...12 V. HTTP-REST API üzerinden erişime açık dosya tipleri...13 VI. VERDA API ye hızlı bağlantı testi nasıl yapabilirim?...15 Doküman Tarihçesi Sürüm Tarih Değişiklik Özeti Onay v0.1 09.06.2015 İlk Sürüm Bilgi Yönetimi UGB v1.0 15.06.2015 API üzerinden erişime açık dosya Bilgi Yönetimi UGB tipleri güncellendi. 17.06.2015 Verda API Test adresi güncellendi. Bilgi Yönetimi UGB v1.01 26.06.2015 Şifre Değiştirme servisi eklendi. Bilgi Yönetimi UGB v1.02 06.08.2015 Dosya Tip Listesi güncellendi Bilgi Yönetimi UGB v1.03 27.08.2015 Dosya Tip Listesine lastgenerated ve Bilgi Yönetimi UGB expectedgenerationtime bilgileri eklendi. Destek iletişim bilgileri güncellendi. VERDA API Hızlı bağlantı v1.04 31.08.2016 testi için Adım adım bağlantı bilgileri eklendi. Bilgi Yönetimi UGB v1.05 16.02.2017 BISTECH Faz-2 Dosya Tanımları eklendi. Bilgi Yönetimi UGB
3 I. Giriş VERDA (VERi DAğıtım) sistemi, ile iştirak halindeki kurumların (Aracı Kurumlar, Veri Yayın Kuruluşları, Endeks Lisanslama Şirketleri, vb. gibi.) aldıkları hizmetlere ait verilere ve veri dosyalarına ulaşabilecekleri BISTECH ürün ailesi içerisinde geliştirilmiş olan yeni Veri Dağıtım sistemidir. VERDA HTTP-REST API ise kurumların VERDA sistemi üzerindeki veri dosyalarına programatik olarak erişmelerini sağlamak üzere geliştirilmiş olan bir Web Servis uygulamasıdır. Kurumlar bu uygulama üzerinden yetkili oldukları dosyaları belirli kriterler ile sorgulayıp kendi sistemlerine indirebilirler. Dökümanın geri kalanında VERDA HTTP-REST API, sadece API olarak anılacaktır. Bu doküman içerisinde web servisinin kullanım örnekleri wget üzerinden verilmiştir. Sistem standart REST web servis protokolü ile geliştirilmiş olduğundan, entegrasyonu yapacak olan kişi ve kurumlar wget yerine kendi tercih ettikleri herhangi bir programlama dili ve teknoloji ile istemci yazılımlarını geliştirebilirler. * Wget ile ilgili detaylı bilgi http://www.gnu.org/software/wget/manual/wget.html adreslerinden alınabilir. II. Verda API uygulamasına nasıl bağlanabilirim? Kurumların API üzerinden VERDA sistemine erişebilmeleri için kendilerine ait API kullanıcılarını Borsa Yardım Masası ve Destek birimleri ile iletişime geçerek açtırmaları gerekmektedir. API erişim adresleri ve kullanıcı talep süreci aşağıdaki detaylandırılmıştır. a. VERDA API Erişim Adresleri Verda API canlı ve test ortamı adresleri aşağıdaki şekildedir. Test ortamı, kurumların kendi sistemleri ile VERDA API entegrasyon yazılımlarını geliştirme süreçlerinde testlerini yapabilmeleri için sunulmuştur. Her iki ortam için de kurumların kendilerine ait API kullanıcılarını Borsa Kurum Dışı Hizmet Masası ile iletişime geçerek talep etmeleri gerekmektedir. Test ortamlarına internet üzerinden bütün müşterilerimiz erişebilir. Ya da Borsa İstanbul ile VPN bağlantısı olan üyelerimiz diledikleri takdirde BORSA VPN bağlantıları olan bir bilgisayardan VERDA API ortamına erişebilirler. BORSA VPN bağlantısı üzerinden VERDA API ye erişmek isteyen müşterilerimiz ilgili bilgisayarın HOST dosyasına şu ifadeyi eklemelidirler : "10.57.3.9 connect.int.uyg.borsaistanbul.com" Canlı Ortam Adresi: Test Ortam Adresi ( Internet ) : https://verda.borsaistanbul.com https://verdatest.borsaistanbul.com Test Ortamı Adresi ( BORSA VPN ) : http://verda.int.uyg.borsaistanbul.com
4 b. VERDA API Kullanıcısı talep süreci i. Canlı Ortam için kullanıcı talebi API kullanıcısı oluşturulabilmesi için öncelikle her kurumun BIST-Connect sistemine erişimlerini sağlayacakları birer gerçek kişi kullanıcısı olması gerekmektedir. Kurumların BISTCONNECT sistemine erişim almaları için destek sayfasındaki (http://www.borsaistanbul.com/nasdaqdestek/bistechconnect-ve-verda ) BISTECH Connect Kullanıcı Oluşturma Taahhütnamesi dokümanını doldurarak Borsa ya göndermeleri yeterlidir. Bu taahhütname ile ilgili kurum için bir süper kullanıcı tanımı yapılacak ve bu kullanıcının BISTCONNECT ekranları üzerinden VERDA ekranlarına erişimi ve VERDA API kullanıcısının şifresini yönetebilmesi mümkün olacaktır. VERDA sistemine API üzerinden bağlanmak için, Borsa Kurum Dışı Hizmet Masası ve Destek birimleri ile iletişime geçerek şirketinize ait bir API uygulama kullanıcısını ayrıca talep edilmesi gerekmektedir. Talebiniz ardından API kullanıcısı tanımlanacak ve detay bilgileri (kullanıcı adı, geçici şifresi) BISTCONNECT e girmesi için yetkilendirdiğiniz şirket personelinize e-posta ile iletilecektir. E-Posta ile gönderilen API şifresi bloke durumdadır ve kullanılabilir hale gelmesi için şifrenin sıfırlanması ve yeni şifre oluşturulması gerekmektedir. Yetkili personeliniz BIST-Connect uygulamasına giriş yaparak Kullanıcı yönetimi ekranından, şirketiniz için tanımlanmış olan VERDA API kullanıcısının şifresini değiştirmelidir. Şifre değişimini VERDA API Şifre Değiştirme servisi üzerinden de şifreyi değiştirebilirsiniz. Bu şifre değişiminden sonra personelinizin belirleyeceği yeni şifreyi kullanarak, VERDA API ye kullanıcı adı ve şifreniz ile erişiminiz mümkün olacaktır. ii. Test Ortamı için kullanıcı talebi Test ortamı erişimleri için Canlı ortamda olduğu gibi gerçek bir BISTCONNECT kullanıcısı gerekmemektedir. bistechsupport_autoticket@borsaistanbul.com adresine başvuru yaparak test ortam üzerinde kurumunuz için tanım yapılmasını ve kullanıcı bilgilerini edinebilirsiniz. III. Verda API Kullanım Detayları a. KİMLİK DOĞRULAMA API a yapılan her istek kimlik doğrulamadan geçer. Her istek kimlik bilgisi içermelidir. API kullanımı HTTP Basic Authentication yöntemi ile yapılır. i. Kimlik doğrulama sebebiyle oluşabilecek hata mesajları ve anlamları: 1. 401 Unauthorized: Hatalı kullanıcı adı ya da şifre 2. 401 Unauthorized: Kullanıcı bloklanmış 3. 401 Unauthorized: Kullanıcı pasif 4. 403 Forbidden: Kullanıcı tipi VERDA REST API için yetkili değil
5 ii. Örnek: Kimlik doğrulama için örnek bir mesaj: Kullanıcı adı U2354API ve şifre 123456 ile API ya istek yapılması HTTP isteğinde Authorization header ı olmalıdır ve değeri <kullanıcı>:<şifre> değerinin, yani bu örnekte U2345API:123456 değerinin Base64 e göre şifrelenmiş haline eşit olmalıdır. Örnek > wget --user="u2354api " --password="123456" "https://verda.borsaistanbul.com/files" --auth-nochallenge - qso HTTP Request GET /files HTTP/1.1 Host: verda.borsaistanbul.com Authorization: Basic dtizndvhcgk6mtizndu2 b. ŞİFRE DEĞİTİRME Verda API kullanıcısının şifresini değiştirmek için kullanılır. Uzantı HTTP Metodu Gerekli Headerlar Parametreler Cevap Tipi Cevap Hata Mesajları https://verda.borsaistanbul.com/change-password POST HTTP Basic Authentication bilgisi (bakınız: KİMLİK DOĞRULAMA ) newpassword Zorunlu. Yeni şifre. oldpassword Zorunlu. Mevcut(eski) şifre. HTTP Cevap kodları ve Mesajlar 200 - Password change successful 400 - New password must be different than the old password. It must be at least 8 characters and contain at lease one upper case, one lower case character and a digit.
6 i. Örnek: Şifre Değiştirme Örnek >wget http://10.57.2.78:3040/change-password/ --user="u22623api" --password="u22623api" -- post-data='"oldpassword":"u22623api", "newpassword":"aa1234567"}' --header=content- Type:application/json --auth-no-challenge -qso- HTTP Request POST /change-password HTTP/1.1 Host: verda.borsaistanbul.com Authorization: Basic dtiynjizyxbpokfhmtizndu2 Cache-Control: no-cache HTTP Response HTTP/1.1 200 OK X-Request-Id: b830eebb-918e-4460-b424-5aec80b8fe9e Content-Type: application/json Date: Fri, 26 Jun 2015 08:58:44 GMT Connection: keep-alive Transfer-Encoding: chunked Proxy-Connection: keep-alive Password change successful c. DOSYA TİPLERİNİ LİSTELEME Dosya tiplerini listeleme uzantısı ile sadece kurumunuzun erişim yetkisi olduğu dosya tipleri listelenir. Bu liste ile sayesinde API üzerinden hangi dosyalara erişebileceğinizi görüp dosya tipleri hakkındaki bilgilere ulaşabilirsiniz. Ayrıca dönen cevap içerisindeki links başlığı ile ilgili dosya tipinden bir dosyayı (veya JSON içeriğini) indirebilmeniz için çağırım örnekleri listelenmektedir. Uzantı https://verda.borsaistanbul.com/files HTTP Metodu GET Gerekli Headerlar HTTP Basic Authentication bilgisi (bakınız: KİMLİK DOĞRULAMA ) Parametreler - Cevap Tipi Liste (dosya tipleri) ya da HTTP bazlı hata kodları Alanlar id name-tr name-en Dosya tipi ID Dosya ismi (Türkçe) Dosya ismi (İngilizce) frequency Dosya oluşturma sıklığı (Yıllık, Günlük, Aylık, Seanslık, Saatlik, Kümülatif) Dosyanın bugün içinde oluşturulacağı tahmini saat bilgisini verir. Dosya bu saatten sonra kısa bir süre içerisinde oluşturulup sisteme yüklenecektir. Bu günün tam veya yarım işlem günü olmasına bağlı
7 Cevap Yapısı expectedgenerationtime json olarak uygun saatler dönecektir. Bu gün işlem günü değil ise null olacaktır. Sadece günlük olarak oluşturulan dosyalar için geçerlidir. Diğer dosya tipleri için null olacaktır. Veri formatı : hh:mm:ss +TimeZone Örnek : "17:45:00 +0300" JSON olarak da alınabilir (true, false) lastgenerated lastgeneratedfilename Sistemde en son oluşan dosyanın oluşma zaman bilgisini verir. Örnek: "16-06-2015 17:45:28" Sistemde en son oluşan dosyanın adı Örnek : "CB_20150616.csv" links İçerik indirme linkleri: Sistemde oluşan son dosya: Tarih kriteri girmeksizin sistemde oluşan son dosyayı indirmek için takip edilmesi gereken link. Örnek tarihli dosya: Dosyanın oluşma periyoduna göre örnek link. Parametrelerin değerleri isteğin yapıldığı güne göre oluşturulur. Örnek linktir, her zaman var olan bir dosyaya işaret etme. JSON icerikli dosya linki: Eğer dosya içeri JSON olarak sunulabiliyorsa, JSON içerik isteme linki. Hata Mesajları Bu uzantıya yapılan istekten alınabilecek hatalar ancak kimlik doğrulama kaynaklı olabilir (bkz: Error! Reference source not found.)
8 i. Örnek: Dosya Tiplerinin Listelenmesi: Yetki Dahilindeki Dosya Tiplerinin Listelenmesi: Örnek >wget --user="u22623api" --password="qweqwe" "https://verda.borsaistanbul.com/files" -- auth-no-challenge -qso HTTP Request GET /files HTTP/1.1 Host: verda.borsaistanbul.com Authorization: Basic dtiynjizyxbpokfhmtizndu2 Cache-Control: no-cache HTTP Response Access-Control-Allow-Methods GET, HEAD, POST Connection keep-alive Content-Encoding gzip Content-Type application/json Date Thu, 11 Jun 2015 17:11:28 GMT Server borsa Transfer-Encoding chunked [ "id": 57, "name": "Tüm emirler", "frequency": "Daily", "expectedgenerationtime": "17:45:00 +0300", "json": false, "lastgenerated": "10-06-2015 17:45:28", "lastgeneratedfilename": "TED_20150610.csv", "links": [ "description": "Download Latest file", "href": "files/download?type=57" }, "description": "Download Latest File with Date/Session Criteria", "href": "files/download?type=57&year=2015&month=6&day=11" } ] }, "id": 102, "name": "Toplam İşlem Hacmi, İşlem Miktarı ve Sözleşme Sayısı", "frequency": "Daily", "expectedgenerationtime": "17:45:00 +0300", "json": false, "lastgenerated": "10-06-2015 17:46:48", "lastgeneratedfilename": "TIS_20150610.csv", "links": [ "description": "Download Latest file", "href": "files/download?type=102" }, "description": "Download Latest File with Date/Session Criteria", "href": "files/download?type=102&year=2015&month=6&day=11" } ] }, "id": 103, "name": "Üye Bazında Seanslık İşlem Sıralaması", "frequency": "Each Session", "expectedgenerationtime": "17:45:00 +0300", "json": false, "lastgenerated": "10-06-2015 17:45:38", "lastgeneratedfilename": "UI_20150610.zip", "links": [ "description": "Download Latest file", "href": "files/download?type=103" }, "description": "Download Latest File with Date/Session Criteria", "href": "files/download?type=103&year=2015&month=6&day=11&session=1" } ] },..... ]
9 d. DOSYA İNDİRME Uzantı HTTP Metodu Gerekli Headerlar https://verda.borsaistanbul.com/files/download GET HTTP Basic Authentication bilgisi (bakınız: KİMLİK DOĞRULAMA ) type Zorunlu. Dosya tipi year month Opsiyonel. Dosya oluşma yılı Opsiyonel. Dosya oluşma ayı Parametreler day Opsiyonel. Dosya oluşma günü hour session media Opsiyonel. Dosya oluşma saati Opsiyonel. Dosya oluşma seansı Opsiyonel (sadece json olabilir) Cevap Tipi Cevap Yapısı Hata Mesajları Dosya, JSON formatında dosya içeriği ya da HTTP bazlı hata mesajları 1- Dosyanın kendisi multipart/form-data olarak alınır. 2- veya JSON olarak içeriği (application/json) alınabilir. Kimlik doğrulama kaynaklı hatalar (bkz: Error! Reference source ot found.) 403 Forbidden: İstenilen dosya tipi geçersiz ya da bu dosya tipine kullanıcının yetkisi yok 403 Forbidden: İstenilen dosya API yoluyla indirilemez 404 Not Found: Dosya tipi dışında belirtilen kriterlerde (yıl, ay vs) bir dosya bulunamadı. Kriterler değiştirilmeli ya da kaldırılmalı 415 Unsupported Media Type: İstek yapılan dosya tipi JSON formatında sunulamıyor. Media parametresi kaldırılarak denenmeli 500 Internal Server Error: BIST kaynaklı bir hata oluştu. BIST le iletişime geçilmeli.
10 i. Örnek: Verileri dosya formatında indirme: Kira sertifkaları endeks bilgilerini veri dosyası olarak indirme Örnek >wget --user="u22623api" --password="qweqwe" "https://verda.borsaistanbul.com/files/download?type=204" --auth-no-challenge -- content-disposition qs HTTP Request GET /files/download?type=204 HTTP/1.1 Host: verda.borsaistanbul.com Authorization: Basic dtiynjizyxbpokfhmtizndu2 Cache-Control: no-cache HTTP Response Access-Control-Allow-Methods GET, HEAD, POST Connection keep-alive Content-Encoding gzip Content- Type multipart/form-data Date Thu, 11 Jun 2015 17:25:06 GMT Server borsa Transfer- Encoding chunked X-Request-Id 45ff606a-6fcd-40f4-8642-38b8d91c6899 content-disposition attachment; filename=lease_certificates_indices.csv vary Accept-Encoding Not: lease_certificates_indices.csv isimli dosya komutun çağrıldığı klasöre indirilir.
11 ii. Örnek: Verileri JSON formatında indirme: Kira sertifkaları endeks bilgilerini JSON formatında alma >wget --user="u22623api" --password="qweqwe" Örnek "https://verda.borsaistanbul.com/files/download?type=57&media=json" --auth-no-challenge -- content-disposition qso HTTP Request GET /files/download?type=204&media=json HTTP/1.1 Host: verda.dev.uyg.borsaistanbul.com Authorization: Basic dtiynjizyxbpokfhmtizndu2 Cache-Control: no-cache HTTP Response Access-Control-Allow-Methods GET, HEAD, POST Connection keep-alive Content-Encoding gzip Content-Type application/json Date Thu, 11 Jun 2015 17:30:12 GMT Server borsa Transfer-Encoding chunked X-Request-Id 95dbba27-c747-4bb0-bddc-9e90c2e70ecf vary Accept-Encoding [ }, }, }. "Date": "28/06/2013", "GovernmentLeaseCertificates": "100.0", "CorporateLeaseCertificates": "100.0" "Date": "01/07/2013", "GovernmentLeaseCertificates": "99.95025", "CorporateLeaseCertificates": "100.06017" "Date": "02/07/2013", "GovernmentLeaseCertificates": "100.14951", "CorporateLeaseCertificates": "100.08023"
12 IV. Verda hakkında nasıl destek alabilirim? Verda uygulaması ve HTTP-REST API hakkındaki soru ve yardım talepleriniz için aşağıdaki irtibat adresleri ile iletişime geçebilirsiniz; - VERDA Destek e-posta adresi : bistechsupport_autoticket@borsaistanbul.com - Borsa Kurum Dışı Hizmet Masası Telefonu : +90.212.298.24.27 #1 Herhangi bir hata ile karşılaşmanız durumunda, size daha iyi destek verebilmemiz için alınan hata ile ilgili detaylı bilgileri aşağıdaki formatta bistechsupport_autoticket@borsaistanbul.com adresine bildirmenizi rica ederiz. Hata mesajı içerisindeki errorid veya X-Request-ID ile belirtilen değer hatanızın tarafımızca LOG kayıtları içerisinden araştırılabilmesi için gönderilmesi önem arz etmektedir. Verda Hata Bildirim Örnek Şablon; Uzantı HTTP Metodu GET Tarih ve Saat Bilgisi 05.06.2015 14:33 Kullanıcı Adı https://verda.borsaistanbul.com/files/download?type=57 U22623API "code": "ForbiddenError", Hata mesajı json olarak geliyorsa "message": "User does not have access to specified file type, or requested file type is available only on BISTConnect", "errorid": "1f125048-d001-47d3-89c8-e0703651bb1f" } Hata mesajının içeriği boş ise X-Request-Id 561ee879-10ee-4090-acb5-4d00d6c96aa0
13 V. HTTP-REST API üzerinden erişime açık dosya tipleri API ile VERDA sistemi üzerindeki dosya türlerinden kurumların sadece programatik olarak entegrasyon ihtiyacı duyabilecekleri dosyalara erişim sunulmaktadır. Mevcut liste aşağıdaki şekildedir. Her kurum kendi almış olduğu ürün ve hizmet özelliklerine göre aşağıdaki listeden yetkisi dâhilinde olan dosyalara erişebilirler. File Dosya Açıklaması File Description Period File Name Prefix File Name JSON Type DateTime Supp ID Suffix ort 57 BISTECH PP - Tüm Emir Defteri BISTECH EQ - All Orders Book Daily TED_ false 58 BISTECH PP - Bülten BISTECH EQ - Bulletin Daily BUL_ false 82 BISTECH PP - Üye İşlem Defteri BISTECH EQ - Member Trade Book Daily UID_ false 136 BISTECH PP - Net İşlem Defteri BISTECH EQ - Net Trading Book Daily NID_ false 140 BISTECH PP - Sabah Marj Bilgileri BISTECH EQ - Morning Margin Information Daily MAS_ false 141 BISTECH PP - Akşam Marj Bilgileri BISTECH EQ - Evening Margin Information Daily MAA_ false 142 BISTECH PP - Emir İptal Defteri BISTECH EQ - Order Cancellation Book Daily EID_ false 143 BISTECH PP - İşlem Tarafı Gün Sonu Bilgileri (VYK) BISTECH EQ - Broker ID End of Day Information File Daily TB false (Data Distributor) 144 BISTECH PP - Gün Sonu Bilgileri (VYK) BISTECH EQ Daily Bulletin (Data Distributor) Daily PAY_BULTEN_ false 145 BISTECH PP - Günlük Özet Dosyası(VYK) BISTECH EQ Daily Summary File (Data Daily PAY_GENEL_TOPLAM_ false Distributor) 257 BISTECH Sermaye Artırımı, Temettü Ödemesi ve Benzeri BISTECH Corporate Actions File Daily SERMAYE_ARTIRIMI_ false Şirket Bilgileri Dosyası 258 BISTECH Endeks Bölen Dosyası - Düzeltme Öncesi BISTECH EQ - Net Trading Book Daily endeks_bolen_do_genel_ false 259 BISTECH Endeks Bölen Dosyası - Düzeltme Sonrası BISTECH EQ - Net Trading Book Daily endeks_bolen_ds_genel_ false 260 BISTECH Endeks Ağırlık Dosyası - Düzeltme Öncesi BISTECH EQ - Net Trading Book Daily endeks_agirlik_do_genel_ false 261 BISTECH Endeks Ağırlık Dosyası - Düzeltme Sonrası BISTECH EQ - Net Trading Book Daily endeks_agirlik_ds_genel_ false 262 BISTECH PP Endeksleri Gün Sonu Bilgileri Dosyası - Fiyat BISTECH Equity Market Indices Daily Information Daily fiyat_endeks_ false Endeksleri Dosyası Files-Price Indices File 275 BISTECH PP Endeksleri Gün Sonu Bilgileri Dosyası - BISTECH Equity Market Indices Daily Information Daily getiri_endeks_ false Getiri Endeksleri Dosyası Files-Return Indices File 196 BIST KYD ÖST Endeksleri BIST KYD Corporate Bond Indices Daily - Cumulative corporate_bonds_indices false 197 BIST KYD DIBS Endeksi BIST KYD CPI Index Daily - Cumulative cpi_index false 198 BIST KYD - 1 Aylık Gösterge Mevduat Endeksleri BIST KYD 1 Month Deposit Rates Indices Daily - Cumulative deposit_rates_indices false 199 BIST KYD Eurobond Endeksleri BIST KYD Eurobond Indices Daily - Cumulative eurobonds_indices false 200 BIST KYD Fon Endeksleri BIST KYD Fund Indices Daily - Cumulative fund_indices false 201 BIST KYD TÜFE Endeksleri BIST KYD GDS Indices Daily - Cumulative gds_indices false 202 BIST KYD Altın Endeksleri BIST KYD Gold Indices Daily - Cumulative gold_indices false
14 13 203 BIST KYD Endeks Ağırlıkları BIST KYD Index Weights Daily index_weight.d. TRUE 204 BIST KYD Kira Sertifikaları Endeksleri BIST KYD Lease Certificates Indices Daily - Cumulative lease_certificates_indices false 205 BIST KYD 1 Aylık Kar Payı Endeksleri BIST KYD 1 Month Profit Share Indices Daily - Cumulative profit_share_indices false 206 BIST KYD Repo Endeksleri BIST KYD Repo Indices Daily - Cumulative repo_indices false 207 BIST KYD Endeksi BIST KYD Index Daily indices.d. TRUE 1 MKK - Hisse Senedi Yerli Yabancı Saklama Oranları MKK - Hisse Senedi Yerli Yabancı Saklama Oranları Daily HSYY_ false Raporu Raporu 2 MKK - Üye Saatlik Bakiye Raporu MKK - Üye Saatlik Bakiye Raporu Hourly USB_ hh false 3 MKK - Hisse Senedi Fiili Dolaşımda Bulunan Paylar MKK - Hisse Senedi Fiili Dolaşımda Bulunan Paylar Daily HSFP_ false Raporu Raporu 4 MKK - Yatırım Fonu Fon Yönetim Ücretleri Raporu MKK - Yatırım Fonu Fon Yönetim Ücretleri Raporu Daily YFFU_ false 5 MKK - Hisse Senedi Dönüşüm İşlemleri Raporu MKK - Hisse Senedi Dönüşüm İşlemleri Raporu Daily HSDI_ false 6 TAKAS - BEFEXP TAKAS - BEFEXP Daily BEFEXP ddmmyy false 7 TAKAS - BEFFON TAKAS - BEFFON Daily BEFFON ddmmyy false 8 TAKAS - BEFHYP TAKAS - BEFHYP Daily BEFHYP ddmmyy false 9 TAKAS - BEFIHD TAKAS - BEFIHD Daily BEFIHD ddmmyy false 10 TAKAS - BEFPDI TAKAS - BEFPDI Daily BEFPDI ddmmyy false 11 TAKAS - BEFTSB TAKAS - BEFTSB Daily BEFTSB ddmmyy false 12 TAKAS - BEFYUZ TAKAS - BEFYUZ Daily BEFYUZ ddmmyy false 13 TAKAS - EXP TAKAS - EXP Daily EXP ddmmyy false 14 TAKAS - FON TAKAS - FON Daily FON ddmmyy false 15 TAKAS - FPFGN TAKAS - FPFGN Daily FPFGN ddmmyy false 16 TAKAS - FPFON TAKAS - FPFON Daily FPFON ddmmyy false 17 TAKAS - FPKST TAKAS - FPKST Daily FPKST ddmmyy false 18 TAKAS - FPUYE TAKAS - FPUYE Daily FPUYE ddmmyy false 19 TAKAS - HYP TAKAS - HYP Daily HYP ddmmyy false 20 TAKAS - IHD TAKAS - IHD Daily IHD ddmmyy false 21 TAKAS - PDI TAKAS - PDI Daily PDI ddmmyy false 22 TAKAS - TSB TAKAS - TSB Daily TSB ddmmyy false 23 TAKAS - YUZ TAKAS - YUZ Daily YUZ ddmmyy false
BISTECH Faz-2 VIOP ( Derivatives Market ) Geçişiyle birlikte, sistemlerimizde VIOP piyasasıyla ilgili olarak yayınlanacak olan dosya tipleri ile ilgili temel bilgiler aşağıda yer almaktadır. Dosyaların sisteme yüklenme zamanları ve şirketinizin erişebileceği dosyaların güncel bilgilerine https://verda.borsaistanbul.com/files adresinden VERDA API Kullanıcı adı ve şifrenizi kullanarak erişebilirsiniz. 15 Dosya No / File Type ID Dosya Adı / File Name Dosya Açıklaması File Description(EN) Tarih Formatı ( Date Format) Periyot ( Period ) 706 vtb_ Gün Sonu İşlem Tarafı Verileri Dosyası Broker ID End of Day Information File 702 VIOP_UID_ Üye İşlem Defteri Member Trade Book 703 VIOP_TED_ Tüm Emir Defteri All Orders Report 704 VIOP_BUL_NS_ Bülten (Normal Session) Daily Bulletin (Normal Session) 705 VIOP_BUL_AH_ Bülten (After Hour Session) Daily Bulletin (After Hour Session) 707 viopms_ Mevcut Sözleşmeler Contracts File 708 vgs_ Günsonu Pozisyon Dosyası End of Day Holdings Report Piyasa Yapıcı Günlük Performans Raporu (Normal 723 vpyp_normal Session) Daily Market Making Performance Report (Normal Session) Piyasa Yapıcı Aylık Performans Raporu (Normal 725 vpymr_normal _ Session) Monthly Market Making Performance Report (Normal Session) Piyasa Yapıcı Aylık Performans Raporu (After Hour Monthly Market Making Performance Report (After Hour 726 vpymr_aht _ Session) Session) 263 VIOP_BULTEN_ Gün Sonu Bilgileri Dosyası Daily Bulletin 264 VIOP_BULTEN_OZET_ Özet Bilgiler Dosyası Daily Summary File 709 vuhf_ Üye Bazında İşlem Hacimleri (Vadeli) Member Based Traded Value (Futures) 710 vuho_ Üye Bazında İşlem Hacimleri (Opsiyon) Member Based Traded Value (Options) 722 vpys_ Piyasa Yapıcı Günlük Sözleşme Raporu Daily Market Making Contracts Report 724 vpyp_aht_ Piyasa Yapıcı Günlük Performans Raporu(AHT) Daily Market Making Performance Report (After Hour Session) 742 voz_ Özsermaye Halleri Dosyası Corporate Action File 743 vsz_ Sözleşme Değişiklik Dosyası List of Newly Listed/Delisted/Expired Contracts 744 vsuz Vade Sonu Uzlaşma Fiyatları Final Settlement Prices 745 VBP.M. Üye Borsa Payı Detay Raporu Member Based Exchange Fee Detail Report 746 VGD.M. Geri Dağıtım Raporu Rebate Report 747 VIOP_BUL_NS_GECICI_TMP Geçici Bülten (Normal Session) Temporary Bulletin (Normal Session) yyyymm yyyymm yyyymm yyyymm Aylık ( Monthly ) Aylık ( Monthly ) Aylık ( Monthly ) Aylık ( Monthly )
16 VI. VERDA API ye hızlı bağlantı testi nasıl yapabilirim? Aşağıda, VERDA API ye nasıl hızlı ve basitçe bağlantı yapabileceğinizi ve bağlantınızı test edebileceğinizi adım adım aşağıda bulabilirsiniz : 1- CONNECT Super User için Borsa İstanbul a başvurmalısınız. Borsa İstanbul tarafından kullanıcı tanımlaması yapılmış olmalı. 2- VERDA API Kullanıcnız için Borsa İstanbul a başvurmalısınız. Borsa İstanbul tarafından kullanıcı tanımlamanız yapılmış olmalı. 3- CONNECT Super Kullanıcınız connect.borsaistanbul.com a giriş yaparak VERDA API Kullanıcınızın şifresini, Super Kullanıcıya gönderilen e-posta içerisindeki geçici şifreyi kullanarak sıfırlamalı, yeni bir şifre belirlemelidir. Bu işlem CONNECT -> Kullanıcılar ve Yetkiler -> API ve Uygulama Kullanıcıları -> Şifre Değiştir butonu üzerinden yapılabilir. NOT : e-posta nın gelmediğini düşünüyorsanız. Lütfen SpamBox/JunkBox ınızı da kontrol ediniz. 4- VERDA API kullanıcı bağlantı testini yapmak için internete bağlı olan bir bilgisayardan, Google Chrome tarayıcısının güncel versiyonun yükleyiniz. 5- Google Chrome Web Store da yer alan POSTMAN eklentisini Google Chrome a kurunuz. Ve çalıştırınız. 6- Aşağıdaki resimde POSTMAN ekranında adım adım nasıl VERDA API bağlantınızı test edebileceğinizi görebilirsiniz : Adım 1 Authorization menüsüne basın. Adım 2 Authorization tipi olarak Basic Auth seçin. Adım 3 Size Borsa İstanbul a yaptığınız başvuru sonucu verilen VERDA API Kullanıcı adını giriniz. Adım 4 connect.borsaistanbul.com a girerek sıfırladığınız yeni VERDA API şifrenizi giriniz. Adım 5 Update Request butonuna basınız. Adım 6 Get protokolünün seçili olduğundan emin olunuz. Adım 7 Erişmek istediğiniz VERDA API fonksiyonu için ilgili URL i yazınız. i. https://verda.borsaistanbul.com /files : Bu fonksiyon ile şirketinize yetkilendirilmiş dosya tiplerinin listesi ve bu dosya tipiyle ilgili çeşitli bilgileri sorgulayabilirsiniz. ii. https://verda.borsaistanbul.com /files/download?type=xxx : Bu fonksiyon ile XXX yazan yere indirmek istediğiniz dosyanın tip numarasını yazarak, seçtiğiniz dosya tipindeki sisteme son yüklenmiş olan dosyayı indirebilirsiniz. iii. https://verda.borsaistanbul.com /files/download?type=xxx&year=yyyy&month=mm&day=dd : Bu fonksiyon ile XXX yazan yere indirmek istediğiniz dosyanın tip numarasını yazarak, YYYY kısmına yıl, MM kısmına ay ve DD kısmına gün bilgisini yazarak seçtiğiniz dosya tipindeki sisteme belirttiğiniz tarihteki bir dosyayı indirebilirsiniz. Adım 8 Send butonuna basarak sorgulama yapınız. NOT : VERDA API den indirilen bazı dosya tipleri zip formatında olabilir ve indirildikten sonra unzip yapılması gerekebilir. VERDA API Entegrasyonunda bu husus göz önünde bulundurulmalıdır.
17 NOT : VERDA API den https://verda.borsaistanbul.com /files sorgusunu yaptığınızda her dosya tipindeki dosyanın sisteme tahmini yüklenme saati belirtilmiştir. Dolayısıyla VERDA sistemlerini gereksiz meşgul etmemek için yapılacak entegrasyonlarda dosyaların expectedgenerationtime alanına dikkat edilmesini rica ederiz. NOT : VERDA API ile ilgili test ortamları için kullanıcı adı ve şifre edinmek için bistechsupport_autoticket@borsaistanbul.com dan destek talep ediniz. NOT : CONNECT ile ilgili test ortamları için kullanıcı adı ve şifre edinmek için bistechsupport_autoticket@borsaistanbul.com dan destek talep edebilirsiniz. CONNECT Test ortamlarında her şirkete ait tek bir kullanıcı tanımlanmaktadır. Bu kullanıcının test ortamında şifresi güncellenememektedir.
18