BISTECH VERDA. HTTP-REST API Entegrasyon Dokümanı HTTP REST. 29.08.2015 BISTECH VERDA http-rest API Entegrasyon Dokümanı



Benzer belgeler
BISTECH VERDA. HTTP-REST API Entegrasyon Dokümanı. HTTP REST v BISTECH VERDA http-rest API Entegrasyon Dokümanı

Faz 2+ BISTECH KMTP FIX Bilgilendirme Toplantısı 19 Ekim 2017

Medula Eczane Stok Bilgileri Web Servisleri Kullanım Kılavuzu

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

PAKET TRANSFER SİSTEMİ

BOTAŞ EBT BİLGİ YÖNETİM SİSTEMİ WEB SERVİSLERİ

T.C.SOSYAL GÜVENLİK KURUMU. Genel Sağlık Sigortası Medula Optik E-rapor Web Servisleri Kullanım Kılavuzu

BOTAŞ EBT BİLGİ YÖNETİM SİSTEMİ WEB SERVİSLERİ

SMS API. KobiKom Telekomunikasyon A.Ş. SMS API Kullanım Bilgilerini İçerir. Tel: Fax:

ÇÖZÜM BİLGİSAYAR KOLAY RANDEVU RANDEVU WEB SERVİSLERİ YAZILIM FİRMALARI ENTEGRASYON KILAVUZU Sürüm: 1.0

Global Haberleşme API Kullanıcı Notları

T.C.SOSYAL GÜVENLİK KURUMU. Genel Sağlık Sigortası Medula Optik E-rapor Web Servisleri Kullanım Kılavuzu

Tel : 0(532) Web : E-Posta : info@kayikcioglugrup.com. İLETİ PAKETİ API (Entegrason) Dökümanı

PAKET TRANSFER SİSTEMİ

T.C.SOSYAL GÜVENLİK KURUMU. Genel Sağlık Sigortası Medula Optik E-rapor Web Servisleri Kullanım Kılavuzu

Tarih: 2 Ağustos 2018 Son versiyon: 1.8. EndNote X9 Windows Multi/Site kurulum talimatları

ARCHICAD in EĞİTİM SÜRÜMÜ İÇİN BAŞVURU YAPILMASI

MOKA ÖDEME SERVİSİ BAYİ İŞLEMLERİ ENTEGRASYON DOKÜMANI

4os İSTANBUL. BORSASI îstiııye istanbul Tel. : (0212) Faks: (0212) Genelge No Gözetim Müdürlüğü. İstanbul, 18 Mart 1999

V-Count API v İnsan Sayma sonuçları için istekler adresine gönderilecektir.

Submit metodu birden fazla numaraya aynı içerikli kısa mesaj gönderimi için kullanılmaktadır.

Web Server Sunucu Loglarının K-Komşu Algoritması ile İ ncelenmesi

MutluSantral API Dokümanı. Versiyon 1.0.1

ICE BİLİŞİM TEKNOLOJİLERİ WEB SERVİS KILAVUZU. SERVİS LİNK: DÜZENLEME TABLOSU

KMTP API Kurallar Dokümanı Mayıs 2015, Sürüm 1.5.0

KURUMSAL YÖNETİM VE YATIRIMCI İLİŞKİLERİ PORTALI İHRAÇÇI ÜYELİK KILAVUZU

Sol tarafta yer alan Click here to activate your account linkini seçiniz.

MİLLİ EĞİTİM BAKANLIĞI YENİ EPOSTA SİSTEMİ HAKKINDA MEB

T.C.SOSYAL GÜVENLİK KURUMU. Genel Sağlık Sigortası Medula Optik E-reçete Web Servisleri Kullanım Kılavuzu

Üst Düzey Programlama

PAY PİYASASI BISTECH FIX SERTİFİKASYON PROGRAMI REFERANS DATA AŞAMASI İLERİ SEVİYE

%20dolor%20sit%20amet&receipents= , &sender=PROAKTIF

Medula Eczane E-Reçete Web Servislerinin Kullanım Kılavuzu (Test amaçlıdır, ödemeye esas teşkil etmeyecektir)

NicProxy Registrar WHMCS Modül Kurulumu Versiyon 1.0

um%20dolor%20sit%20amet&receipents= , &sender=ILETICELL İstekte gönderilen parametrelerin açıklamaları aşağıdaki gibidir:

PAKET TRANSFER SİSTEMİ

dcc.com Nedir? Neler yapabilir? Nasıl Kullanılır?

Doküman JETSMS XML Mesaj Đşlemleri Yardım Dokümanı Tarih Sürüm 1.1.0

Medula Eczane E-Reçete Web Servislerinin Kullanım Kılavuzu (Test amaçlıdır, ödemeye esas teşkil etmeyecektir)


JETSMS XML Mesaj İşlemleri Yardım Dokümanı Tarih Sürüm XML ile Mesaj İşlemleri

GOLDMESAJ SMS API DÖKÜMANI

Medula Eczane Reçete ve Rapor Web Servisleri Kullanım Kılavuzu

VADELİ İŞLEM VE OPSİYON PİYASASI BISTECH FIX SERTİFİKASYON PROGRAMI REFERANS DATA AŞAMASI

IPACK LADDER. Arayüz Dökümantasyonu

3G Sms&MMS GateWay Xml Interface

Ek 1 - BORSA İSTANBUL Bilgileri Listesi

Dış Kurum Entegrasyonları TURKPOS API. Yardım Dokümanı

MIRACLE DATA WORKS KURULUM DOKÜMANI

MOBILEPAX ENTERPRISE API (WEB SERVİS)

Kaynak Kodlardan Derleme. Turquaz Muhasebe. Versiyon 0.2. Hüseyin Ergün. 26 Mart 2005

İÇİNDEKİLER. ERA Danışmanlık. Ataşehir Soyak Yolu Şehit Burak Kurtuluş Cad. Uğurlu Sok No 140/5 Ümraniye İSTANBUL TÜRKİYE

KILAVUZ. AloMKK Sesli Yanıt Sistemi Kullanım Kılavuzu

MOBILEPAX XML PRODUCT API KULLANIM ŞEKLİ

SMSEXPLORER XML API. XML API KILAVUZU v.1.0

Güniçi Piyasası Web Servis Metotları

MVC Kul anıcı Doğrulama ve Yetkilendirme MVC Filtreler Action Filter FilterAttribute IActionFilter FilterAttribute IActionFilter

MÜŞTERİ BİLGİ SİSTEMİ KULLANICI KILAVUZU. Türkiye Kömür İşletmeleri Kurumu

Avrupa Komisyonu Kimlik Tanımlama Sistemi (ECAS) ile Kayıt İşlemi Unutulan şifre Ad-soyad veya e-posta adresi değiştirme 8

ÖRÜN (WEB) GÜVENLİĞİ. Hazırlayan: Arda Balkanay

Açıklama Bölüm Kılavuzun ilk yayım tarihi

TÜİK e-vt. Web Servis Kılavuzu

Ek 1 - İMKB Bilgileri Listesi

VİOPFIX API ÜYE YAZILIMI SERTİFİKASYON PROGRAMI ORTA SEVİYE. Şubat 2015, Sürüm 1.1

Üyeler Arası Hak Kullanım Kaynaklı Talep İşlemleri

V-Count API v3.6 İçindekiler

ŞEKİLLER DİZİNİ AKADEMİK/ İDARİ BİRİM EŞLEŞTİRİLMESİ AKADEMİK /İDARİ BÖLÜM EŞLEŞTİRİLMESİ BİNA EŞLEŞTİRME...

INTERNET SİTESİ KULLANIM KILAVUZU

PERKON PDKS Kurulum ve hızlı başlangıç rehberi

Nisan 2014-v1.0 KMTP API TEST ve SERTİFİKASYON İŞLEMLERİ

TachoMobile Web Uygulaması v1.00.

SGK Otomasyon Tanıtım ve Kullanım Kılavuzu

1. MEVITAS MERKEZİ ELEKTRONİK VERİ İLETİM TOPLAMA ANALİZ SİSTEMİ GENEL İLKELERİ

BAY.t ENTEGRE PRO e-fatura ÇÖZÜMÜ ENTEGRATÖR KULLANIM YÖNTEMİ

VİOPFIX API ÜYE YAZILIMI SERTİFİKASYON PROGRAMI SAKLAMACI ÜYE DROP COPY

QM ERS (Electronic Reporting System) BİLGİ GİRİŞ SAYFASININ KULLANIMI

Öztiryakiler B2B Kullanıcı Klavuzu

Turquaz Windows kurulum dökümanı. ftp://ftp.mirror.ac.uk/sites/ftp.postgresql.org/binary/v7.3.1/windows/pgsql731wina1.exe

TURKCELL HİZMETLERİ. Kullanım Bilgileri. LOGO Kasım 2014

Oturum Öncesi Tanımlı Oturum Kimliği Çerezi Açığı Gökhan

KATILIMCILARA DUYURU ANADOLU HAYAT EMEKLİLİK A.Ş. EMEKLİLİK YATIRIM FONLARI İÇTÜZÜK, İZAHNAME ve TANITIM FORMU DEĞİŞİKLİKLERİ

XML ile Mesaj İşlemleri

Urkund Hızlı Başlangıç Kılavuzu

BISTECH Üye Değerlendirme Bilgilendirme Toplantısı

NicProxy Registrar AWBS Modül Kurulumu Versiyon 1.0

testo Saveris Web Access Yazılım Kullanım kılavuzu

TÜRKİYE İLAÇ VE TIBBİ CİHAZ KURUMU (TİTCK) ELEKTRONİK BAŞVURU YÖNETİMİ (EBS) TALEP BİLDİRİM KULLANICI KILAVUZU

BISTECH İşlem Platformu Devreye Alım Öncesi Üyelerle Genel Testler Test Programı 15 Ağustos 10 Eylül 2015

EPİAŞ ABONE BİLGİLERİ KAYDI KILAVUZ DOKÜMANI V.2. Kullanıcı. Kapsam. Yasal Dayanak. Veri Kayıt Sorumlusu. Veri kayıt süresi. Ekran Adı.

Alba FX döviz işlem platformunu aşağıdaki link üzerinden bilgisayarınıza indiriniz.

Bölüm 10: PHP ile Veritabanı Uygulamaları

Online Protokol Üretim Projesi

Yayınlanma Tarihi: soru ve sorunlarınız için;

MESS BULUT SİSTEMİ ÜYE PORTALI KULLANIM KILAVUZU

1. Defter detaylarına ait bilgilerin, örneğin yevmiye kayıtlarının olduğu dosya 2. Bir nevi kapak sayfası diyebileceğimiz Berat dosyası

T.C. BAHÇEŞEHİR ÜNİVERSİTESİ

Birtel İletişim Teknolojileri

Internet Programming II. Elbistan Meslek Yüksek Okulu Bahar Yarıyılı

T.C. SAĞLIK BAKANLIĞI ĐLAÇ VE ECZACILIK GENEL MÜDÜRLÜĞÜ

Transkript:

BISTECH VERDA HTTP-REST API Entegrasyon Dokümanı HTTP REST 29.08.2015 BISTECH VERDA http-rest API Entegrasyon Dokümanı 0

İçindekiler Doküman Tarihçesi... 1 I. Giriş... 2 II. Verda API uygulamasına nasıl bağlanabilirim?... 2 a. VERDA API Erişim Adresleri... 2 b. VERDA API Kullanıcısı talep süreci... 2 i. Canlı Ortam için kullanıcı talebi... 2 ii. Test Ortamı için kullanıcı talebi... 3 III. Verda API Kullanım Detayları... 3 a. KİMLİK DOĞRULAMA... 3 i. Kimlik doğrulama sebebiyle oluşabilecek hata mesajları ve anlamları:... 3 ii. Örnek: Kimlik doğrulama için örnek bir mesaj:... 3 b. ŞİFRE DEĞİTİRME... 4 i. Örnek: Şifre Değiştirme... 5 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 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 expectedgenerationtime bilgileri eklendi. Bilgi Yönetimi UGB 29.08.2015 BISTECH VERDA http-rest API Entegrasyon Dokümanı 1

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. Canlı Ortam Adresi: https://verda.borsaistanbul.com Test Ortam Adresi: https://verdatest.borsaistanbul.com 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/bistech-connectve-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. 29.08.2015 BISTECH VERDA http-rest API Entegrasyon Dokümanı 2

III. 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. Verda.support@borsaistanbul.com adresine başvuru yaparak test ortam üzerinde kurumunuz için tanım yapılmasını ve kullanıcı bilgilerini edinebilirsiniz. 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 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-no-challenge - qso HTTP Request GET /files HTTP/1.1 Host: verda.borsaistanbul.com Authorization: Basic dtizndvhcgk6mtizndu2 Cache-Control: no-cache 29.08.2015 BISTECH VERDA http-rest API Entegrasyon Dokümanı 3

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 oldpassword Zorunlu. Yeni şifre. 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. 29.08.2015 BISTECH VERDA http-rest API Entegrasyon Dokümanı 4

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 29.08.2015 BISTECH VERDA http-rest API Entegrasyon Dokümanı 5

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) Cevap Yapısı expectedgenerationtime json 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ı 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 Sistemde en son oluşan dosyanın oluşma zaman bilgisini verir. Örnek: "16-06-2015 17:45:28" lastgeneratedfilename Sistemde en son oluşan dosyanın adı Örnek : "CB_20150616.csv" 29.08.2015 BISTECH VERDA http-rest API Entegrasyon Dokümanı 6

İçerik indirme linkleri: Sistemde oluşan son dosya: Tarih kriteri girmeksizin sistemde oluşan son dosyayı indirmek için takip edilmesi gereken link. links Ö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.) 29.08.2015 BISTECH VERDA http-rest API Entegrasyon Dokümanı 7

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" } ]..... ] 29.08.2015 BISTECH VERDA http-rest API Entegrasyon Dokümanı 8

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 Parametreler year month day hour session media Opsiyonel. Dosya oluşma yılı Opsiyonel. Dosya oluşma ayı Opsiyonel. Dosya oluşma günü Opsiyonel. Dosya oluşma saati Opsiyonel. Dosya oluşma seansı Opsiyonel (sadece json olabilir) Cevap Tipi Cevap Yapısı 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. Hata Mesajları 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. 29.08.2015 BISTECH VERDA http-rest API Entegrasyon Dokümanı 9

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 --contentdisposition 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. 29.08.2015 BISTECH VERDA http-rest API Entegrasyon Dokümanı 10

ii. Örnek: Verileri JSON formatında indirme: Kira sertifkaları endeks bilgilerini JSON formatında alma Örnek >wget --user="u22623api" --password="qweqwe" "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" 29.08.2015 BISTECH VERDA http-rest API Entegrasyon Dokümanı 11

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 : verda.support@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 verda.support@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 https://verda.borsaistanbul.com/files/download?type=57 GET Tarih ve Saat Bilgisi 05.06.2015 14:33 Kullanıcı Adı U22623API Hata mesajı json olarak geliyorsa "code": "ForbiddenError", "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 29.08.2015 BISTECH VERDA http-rest API Entegrasyon Dokümanı 12

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 Type ID Dosya Açıklaması File Description Period File Name Prefix File Name DateTime Suffix JSON Supp ort 57 BISTECH PP - Tüm Emir Defteri BISTECH EQ - All Orders Book Daily TED_ yyyymmdd false 58 BISTECH PP - Bülten BISTECH EQ - Bulletin Daily BUL_ yyyymmdd false 82 BISTECH PP - Üye İşlem Defteri BISTECH EQ - Member Trade Book Daily UID_ yyyymmdd false 136 BISTECH PP - Net İşlem Defteri BISTECH EQ - Net Trading Book Daily NID_ yyyymmdd false 140 BISTECH PP - Sabah Marj Bilgileri BISTECH EQ - Morning Margin Information Daily MAS_ yyyymmdd false 141 BISTECH PP - Akşam Marj Bilgileri BISTECH EQ - Evening Margin Information Daily MAA_ yyyymmdd false 142 BISTECH PP - Emir İptal Defteri BISTECH EQ - Order Cancellation Book Daily EID_ yyyymmdd false 143 BISTECH PP - İşlem Tarafı Gün Sonu Bilgileri (VYK) BISTECH EQ - Broker ID End of Day Information File Daily TB yyyymmdd false (Data Distributor) 144 BISTECH PP - Gün Sonu Bilgileri (VYK) BISTECH EQ Daily Bulletin (Data Distributor) Daily PAY_BULTEN_ yyyymmdd false 145 BISTECH PP - Günlük Özet Dosyası(VYK) BISTECH EQ Daily Summary File (Data Daily PAY_GENEL_TOPLAM_ yyyymmdd false Distributor) 257 BISTECH Sermaye Artırımı, Temettü Ödemesi ve Benzeri BISTECH Corporate Actions File Daily SERMAYE_ARTIRIMI_ yyyymmdd false Şirket Bilgileri Dosyası 258 BISTECH Endeks Bölen Dosyası - Düzeltme Öncesi BISTECH EQ - Net Trading Book Daily endeks_bolen_do_genel_ yyyymmdd false 259 BISTECH Endeks Bölen Dosyası - Düzeltme Sonrası BISTECH EQ - Net Trading Book Daily endeks_bolen_ds_genel_ yyyymmdd false 260 BISTECH Endeks Ağırlık Dosyası - Düzeltme Öncesi BISTECH EQ - Net Trading Book Daily endeks_agirlik_do_genel_ yyyymmdd false 261 BISTECH Endeks Ağırlık Dosyası - Düzeltme Sonrası BISTECH EQ - Net Trading Book Daily endeks_agirlik_ds_genel_ yyyymmdd false 262 BISTECH PP Endeksleri Gün Sonu Bilgileri Dosyası - Fiyat BISTECH Equity Market Indices Daily Information Daily fiyat_endeks_ yyyymmdd 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_ yyyymmdd 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 29.08.2015 BISTECH VERDA http-rest API Entegrasyon Dokümanı 13

203 BIST KYD Endeks Ağırlıkları BIST KYD Index Weights Daily index_weight.d. yyyymmdd 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. yyyymmdd TRUE 1 MKK - Hisse Senedi Yerli Yabancı Saklama Oranları MKK - Hisse Senedi Yerli Yabancı Saklama Oranları Daily HSYY_ yyyymmdd false Raporu Raporu 2 MKK - Üye Saatlik Bakiye Raporu MKK - Üye Saatlik Bakiye Raporu Hourly USB_ yyyymmddhh false 3 MKK - Hisse Senedi Fiili Dolaşımda Bulunan Paylar MKK - Hisse Senedi Fiili Dolaşımda Bulunan Paylar Daily HSFP_ yyyymmdd 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_ yyyymmdd false 5 MKK - Hisse Senedi Dönüşüm İşlemleri Raporu MKK - Hisse Senedi Dönüşüm İşlemleri Raporu Daily HSDI_ yyyymmdd 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 29.08.2015 BISTECH VERDA http-rest API Entegrasyon Dokümanı 14