API

Hakem kaydetme

Editörleriniz henüz Scholvet'te olmayan hakemleri tanır. Onları kaydedin; hem sizin hem diğer dergilerin sonraki makaleleri için eşleştirilebilsinler.

Ne zaman çağrılır

Bir editör sisteminizde elle hakem atadığında.
Yazarlar gönderim sırasında hakem önerdiğinde (yalnızca tavsiye ettiklerini gönderin, karşı olduklarını değil).
Derginiz için hakemlik yapmış kişileri aktardığınızda.

POST /v1/reviewers

Bir hakemi kaydeder ya da makalenin anahtar kelimelerini mevcut profiline ekler. Her zaman 202 Accepted döner.

İstek gövdesi

Alan	Tür	Açıklama
`fullName` zorunlu	`string`	Ad soyad, en fazla 200 karakter.
`email` zorunlu	`string`	Yazıştığınız e-posta adresi. Mevcut profili bulmak ve kişiyi bilgilendirmek için kullanılır.
`orcid`	`string`	Biliniyorsa ORCID kimliği. Mevcut profili bulmada e-postadan önce kullanılır.
`academicTitle`	`string`	Akademik unvan.
`institution`	`string`	Kurum; çıkar çatışması denetiminde kullanılır.
`rorId`	`string`	Kurumun ROR kimliği.
`source` zorunlu	`"journal" \| "author"`	Editörlerinizin seçtiği hakemler için journal, yazarların önerdikleri için author.
`articleRef`	`string`	Sizi bu hakemle buluşturan makale; denetim kaydı için.
`keywords`	`string[]`	O makalenin en fazla 30 anahtar kelimesi. Hakemin kendi anahtar kelimelerinden daha az ağırlıkla profile eklenir ve yıllar geçtikçe ağırlığı azalır.
`keywordYear`	`integer`	Geçmiş değerlendirmeler aktarılırken hakemin bu konularla çalıştığı yıl. Anahtar kelimeler eskidikçe daha az ağırlık taşır; varsayılan bu yıldır.
`completedReviews[]`	`object[]`	Kişinin dergi Scholvet'i kullanmadan önce sizin için tamamladığı hakemlikler, en fazla 200. Hakemin deneyimini gösterir, puan kazandırmaz. Aynı hakemliği yeniden göndermek kopya oluşturmaz.
`completedReviews[].completedOn` zorunlu	`date`	Hakemliğin tamamlandığı gün; ör. 2023-05-14.
`completedReviews[].articleRef`	`string`	Makale için sizin kimliğiniz; kaydı tekil tutar. Yoksa gün kullanılır.
`culture`	`"en" \| "tr"`	Kişiye gidecek e-postanın dili. Varsayılan en.

İstek

curl -X POST https://api.scholvet.com/v1/reviewers \
  -H "X-Api-Key: $SCHOLVET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fullName": "Deniz Yılmaz",
    "email": "[email protected]",
    "orcid": "0000-0003-1415-9265",
    "academicTitle": "Dr.",
    "institution": "Ege University",
    "source": "journal",
    "articleRef": "JMIR-2026-0104",
    "keywords": ["graph neural networks", "drug discovery"],
    "culture": "tr"
  }'

Yanıt

HTTP/1.1 202 Accepted

Sonra ne olur

Kişinin profili yoksa Scholvet bir profil oluşturur ve kişi hemen eşleştirilebilir.
Scholvet kişiye tek bir e-posta gönderir: onu kimin kaydettiği, neyin tutulduğu, profili ORCID ile sahiplenme ve silme bağlantıları.
Kişinin profili zaten varsa yalnızca anahtar kelimeler eklenir. Sahibinin sahiplendiği bir profilin üzerine hiçbir zaman yazılmaz.
Kişi kaydını sildiyse hiçbir şey saklanmaz: dergiler onu yeniden kaydedemez. Yanıt yine 202 olur; hangi durumun geçerli olduğu sizden gizlenir.

Sorumluluğunuz

Yalnızca derginizin birlikte çalıştığı ve KVKK ile GDPR'a göre Scholvet'le paylaşmak için hukuki dayanağınız olan kişileri gönderin; bunu kendi aydınlatma metninizde belirtin. Scholvet kaydedilen herkesi bilgilendirir ve kaydını dilediği an silmesine izin verir.

Sonraki: Kullanım ve kota →