TR DİZİN ENTEGRASYONU GELİŞTİRME DOKÜMANI

TR Dizin Arama Motoru: TR Dizin veritabanında Yayın, Dergi, Yazar, Kurum ve Yayıncı alanlarında özelleştirilmiş aramalar yapabilen bir araçtır. Arama yapılmadan önce arama yapılacak alan seçilmelidir.

Veriye Ulaşma Yöntemi

TR Dizin, arayüzden ulaşılan tüm verilere API aracılığıyla ham veri (raw data) olarak da erişilme imkânı sağlamaktadır. Bunun için herhangi bir sayfada bulunan < />JSON butonuna tıklanması yeterli olmaktadır. Bu butona tıklayıp istek yaptığınızda raw datayı json formatında görebiliyor olacaksınız.

Örneğin: https://search.trdizin.gov.tr/tr/yayin/detay/87721/ogretmen-kavrami-ile-ilgili-metaforlara-iliskin-ogrenci-ogretmen-ve-yoneticilerin-gorusleri

URL Özelleştirme

İstediğiniz veriye erişmek için desteklenen parametreler ile url adresini özelleştirebilirsiniz. Örnek arama yapmak için:

https://search.trdizin.gov.tr/api/defaultSearch/{VeriTipi}/?q={Sorgu}&order=relevance-DESC&page=1&limit=20

{VeriTipi} alanı publication (yayın), journal (dergi), author (yazar), institution (kurum) veya publisher (yayıncı) değerlerinden birini alabilir.

order, page ve limit değerleri her sorgu için zorunlu belirtilmesi gereken alanlardır. order parametresi veri tipine göre değişebilmektedir.

Örneğin: https://search.trdizin.gov.tr/api/defaultSearch/publisher/?q=üniversitesi&order=relevance-DESC&page=1&limit=20

Desteklenen URL Parametreleri

Veri Tipi Parametre Adı Alabileceği Değerler Açıklama
publication, journal, author, institution, publisher q String Arama yapmak için kullanılır.
publication facet-documentType [PAPER, PROJECT] Doküman tipine göre filtreleme sağlar.
publication facet-database [SOCIAL, SCIENCE] Veritabanı tipine göre filtreleme sağlar.
publication facet-accessType [OPEN, CLOSED] Erişim formatlarına göre filtreleme sağlar.
publication facet-authorName Ali Yıldız Yazar adına göre filtreleme sağlar.
publication facet-publication_year 2021 Yayın yılına göre filtreleme sağlar.
publication facet-publicationLanguage [TUR, ENG, GER, FRE, ARA, RUS, ITA, SPA, KUR, AZE, KAZ, OTH] Yayın diline göre filtreleme sağlar.
publication facet-journalName Milli Eğitim Dergi adına göre filtreleme sağlar.
publication facet-publicationType [RESEARCH, COMPILATION, FACT_PRESENTATION, OTHER, BOOK_PRESENTATION, CORRECTION, EDITORIAL, LETTER, LETTER_TO_EDITOR, MEETING_SUMMARY, REPORT, SHORT_REPORT, TRANSLATION, RETRACTED, NOTE] Yayın türü tipine göre filtreleme sağlar.
publication facet-projectGroup MAG, TOVAG, SOBAG Proje grubuna göre filtreleme sağlar.
publication facet-facetAuthorInstitution T.C. MİLLİ EĞİTİM BAKANLIĞI Yazarların kurumlarına göre filtreleme sağlar.
publication facet-facetAuthorCountry Türkiye Yazarların ülkelerine göre filtreleme sağlar.
publication facet-facetAuthorCity ANKARA Yazarların şehirlerine göre filtreleme sağlar.
publication facet-subject Fen > Temel Bilimler > Biyoloji Yayın konu tiplerine göre filtreleme sağlar.
publication order={orderCitationCount, publicationYear, title, relevance} [orderCitationCount-DESC,
orderCitationCount-ASC,
publicationYear-DESC,
publicationYear-ASC,
title-DESC,
title-ASC,
relevance-DESC]
Yayın sonuçları yıla, başlığa, atıf sayısına veya aramanın ilgililik oranına göre sıralanabilir.
journal facet-year 2020 Yılına göre filtreleme sağlar.
Sayısal olarak 4 haneli yıl bilgisinin girilmesi gerekir.
journal facet-publicationLanguage [TUR, ENG, GER, FRE, ARA, RUS, ITA, SPA, KUR, AZE, KAZ, OTH] Yayın diline göre filtreleme sağlar.
journal facet-subject Fen > Temel Bilimler > Biyoloji Dergi konu tiplerine göre filtreleme sağlar.
journal order={title, relevance} [title-ASC,
title-DESC,
relevance-DESC]
Dergi sonuçları başlığa veya aramanın ilgililik oranına göre sıralanabilir.
author facet-authorStatus [REAL, POOL] Yazar statüsü tipine göre filtreleme sağlar.
author order={title, orderCitationCount, orderPublicationCount, relevance} [title-ASC,
title-DESC,
orderCitationCount-ASC,
orderCitationCount-DESC,
orderPublicationCount-ASC,
orderPublicationCount-DESC,
relevance-DESC]
Yazar sonuçları atıf sayısına, yayın sayısına, isme veya aramanın ilgililik oranına göre sıralanabilir.
institution facet-type [DEVLETUNIVERSITE, VAKIFUNIVERSITE, KAMUKURULUS, DIGER, KURUMKURULUS, ASKERI, VOD] Kurumların tipine göre filtreleme sağlar.
institution facet-status [OZEL, KAMU, DIGER, YABANCI, STK, KISI] Kurumların statüsüne göre filtreleme sağlar.
institution facet-country Türkiye Kurumların ülkelerine göre filtreleme sağlar.
institution facet-city ANKARA Kurumların şehirlerine göre filtreleme sağlar.
institution order={title, relevance} [title-ASC,
title-DESC,
relevance-DESC]
Kurum sonuçları isme veya aramanın ilgililik oranına göre sıralanabilir.
publisher facet-personType [PERSON, SOCIETY, UNIVERSTY, COMPANY, STATE_AGENCY] Yayıncı tipine göre filtreleme sağlar.
PERSON: Kişi, SOCIETY: Dernek/Vakıf, UNIVERSTY: Üniversite, COMPANY: Şirket, STATE_AGENCY: Kamu Kurumu.
Not: Üniversite değeri servis tarafında UNIVERSTY olarak yazılmaktadır.
publisher order={title, orderJournalCount, relevance} [title-ASC,
title-DESC,
orderJournalCount-ASC,
orderJournalCount-DESC,
relevance-DESC]
Yayıncı sonuçları isme, yayıncıya ait dergi sayısına veya aramanın ilgililik oranına göre sıralanabilir.
publication, journal, author, institution, publisher limit 10, 20, 50, 100 Sayfada kaç tane sonuç gösterileceği ayarlanabilir. En fazla 100 kayıt getirilebilir.
publication, journal, author, institution, publisher page 1, 2, 3 Sonuç sayfaları arasında hangi sayfanın istendiği bilgisi girilmelidir.

Önemli Notlar

Örneğin: https://search.trdizin.gov.tr/api/defaultSearch/publication/?q=cancer&order=publicationYear-DESC&page=1&limit=20&facet-database=SCIENCE&facet-subject=Fen+>+Tıp+>+Onkoloji&facet-publication_year=2019

Örneğin: https://search.trdizin.gov.tr/api/defaultSearch/publisher/?q=&order=orderJournalCount-DESC&page=1&limit=20&facet-personType=SOCIETY&facet-personType=STATE_AGENCY

Tanımlı Kök Adresleri

https://search.trdizin.gov.tr/{veriTipi}/{sorgu}/{değer}

şeklinde bir url adresi oluşturarak ilgili verilere erişebilirsiniz.

Veri Tipi Sorgu Alabileceği Değerler Açıklama
yayin detay Yayın kodu bilgisi İstenilen yayına gitmek için kullanılır.
dergi detay Dergi numara bilgisi İstenilen dergiye gitmek için kullanılır.
yazar detay Yazar kodu bilgisi İstenilen yazara gitmek için kullanılır.
kurum detay Kurum kodu bilgisi İstenilen kuruma gitmek için kullanılır.
yayinci detay Yayıncı kodu bilgisi İstenilen yayıncıya gitmek için kullanılır.

Örneğin: https://search.trdizin.gov.tr/tr/yayin/detay/101406

Örneğin: https://search.trdizin.gov.tr/tr/dergi/detay/592

Örneğin: https://search.trdizin.gov.tr/tr/yazar/detay/762918

Örneğin: https://search.trdizin.gov.tr/tr/kurum/detay/MzU1NTQ0

Örneğin: https://search.trdizin.gov.tr/tr/yayinci/detay/974

Tanımlı URL Adresleri

https://search.trdizin.gov.tr/api/public/{veriTipi}/{sorgu}/?{sorgu}={deger}

şeklinde bir url adresi oluşturarak ilgili JSON verilerine erişebilirsiniz.

Veri Tipi Sorgu Alabileceği Değerler Açıklama
yazar orcid ?orcid=xxxx-xxxx-xxxx-xxxx Yazarın ORCID bilgisi ile ilgili yazarın bilgilerine ulaşılabilir.
dergi issn ?issn=xxxx-xxxx ISSN veya e-ISSN ile ilgili derginin bilgilerine ulaşılabilir.
yayin doi ?doi=xxxxxxxx DOI bilgisi ile ilgili makalenin bilgilerine ulaşılabilir.

Örneğin: https://search.trdizin.gov.tr/api/public/yazar/orcid/?orcid=0000-0001-5199-0284

Örneğin: https://search.trdizin.gov.tr/api/public/dergi/issn/?issn=1303-0035

Örneğin: https://search.trdizin.gov.tr/api/public/yayin/doi/?doi=10.17130/ijmeb.1006420

Erişim Kısıtlamaları ve Kullanım Limitleri

TR Dizin servislerinin tüm kullanıcılar için kesintisiz, adil ve sağlıklı bir şekilde hizmet verebilmesi amacıyla servislere yapılan isteklere aşağıdaki kullanım limitleri uygulanmaktadır:

İsteğin Kaynağı Bir IP Adresinden Dakikada Gönderilebilecek En Fazla İstek Sayısı
Türkiye IP adreslerinden 300 istek
Türkiye dışı IP adreslerinden 60 istek
  • Söz konusu limitler, istekte bulunulan IP adresi bazında uygulanmaktadır. Kurum ve kuruluşlar için kurum ağından internete çıkışta kullanılan çıkış IP adresi (veya adresleri) ortak kabul edilmekte olup aynı çıkış IP adresini kullanan tüm kullanıcıların istekleri birlikte değerlendirilmektedir. Bu nedenle kurumların, kendi bünyelerindeki entegrasyon ve kullanıcı isteklerini toplamda belirtilen limitleri aşmayacak şekilde planlamaları gerekmektedir.

  • İzin verilen limitlerin üzerinde istek gönderilmesi, servislerin sağlıklı çalışmasını engelleyebilecek ve diğer kullanıcıların hizmete erişimini olumsuz etkileyebilecek niteliktedir. Bu kapsamda, belirtilen limitleri aşacak şekilde istek gönderilmesinden doğabilecek her türlü zarardan istekleri gönderen kişiler hukuken sorumludur.

  • Belirtilen limitlerin aşılması durumunda, ilgili istekler hangi kullanıcıdan kaynaklanmış olursa olsun, isteklerin geldiği çıkış IP adresi engellenecek (banlanacak) ve bu IP adresi üzerinden TR Dizin servislerine erişim sağlanamayacaktır.

Servisleri kullanan tüm kişi ve kurumların yukarıda belirtilen kurallara uymaları gerekmektedir.

Değişiklikleri Takip Et Özelliği

TR Dizin üzerinde API entegrasyonlarında yapılan güncellemelerden haberdar olmak için Değişiklikleri Takip Et butonunu kullanabilirsiniz. Giriş yaptıktan sonra ad, soyad ve e-posta bilgileriniz görüntülenecek ve Abone Ol butonuna tıklayarak kaydınızı oluşturabilirsiniz.

Abone olduktan sonra gelişmeler e-posta ile iletilecek, her e-postada yer alan Abonelikten Çık bağlantısı ile istediğiniz zaman aboneliğinizi sonlandırabilirsiniz.