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
-
Bağlantı adresleri büyük küçük harf duyarlı olduğu için dikkat edilmesi gerekmektedir.
-
Facet parametreleri için aynı parametre birden fazla eklenerek çoklu seçim uygulanabilir.
Ö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.

