Yayın ve dergi yönetim sistemleri için entegrasyon belgeleri
Scholvet Entegrasyon Belgeleri

API

Hakem arama

Arama, makaleyi gizli hakem profilleriyle karşılaştırır ve uyum skoruna göre sıralanmış hakem kodları döndürür. Bu aşamada Scholvet hiçbir zaman isim döndürmez.

POST /v1/reviewer-searches

Bir makale için uygun hakemleri bulur. Aramayla birlikte 201 Created döner.

İstek gövdesi

Alan Tür Açıklama
articleRef zorunlu string Makalenin sizdeki kalıcı kimliği, en fazla 80 karakter. Davetlerde ve webhook'larda geri gelir.
title zorunlu string Makale başlığı, en fazla 600 karakter.
abstract string Özet, en fazla 6.000 karakter. Eşleşmeyi iyileştirir ama saklanmaz.
keywords zorunlu string[] 1 ile 30 arası anahtar kelime. Eşleşmede en yüksek ağırlığı taşır.
authors object[] En fazla 50 yazar. Yalnızca çıkar çatışması olan hakemleri dışarıda bırakmak için kullanılır.
authors[].orcid string ORCID kimliği, https://orcid.org/ ile ya da onsuz. Yazarın kendisini ve son beş yıldaki ortak yazarlarını dışarıda bırakır.
authors[].institution string Kurum adı. Aynı kurumdan hakemler dışarıda bırakılır; bir üniversitenin İngilizce ve Türkçe adları aynı sayılır.
authors[].rorId string Kurumun ROR kimliği. Her iki tarafta da varsa addan önce kullanılır.
maxResults integer Döndürülecek hakem sayısı, 1 ile 50 arası. Varsayılan 10.
İstek
curl -X POST https://api.scholvet.com/v1/reviewer-searches \
  -H "X-Api-Key: $SCHOLVET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "articleRef": "JMIR-2026-0104",
    "title": "Deep learning for tumour detection in brain MRI",
    "abstract": "We evaluate convolutional neural networks for tumour detection...",
    "keywords": ["deep learning", "medical imaging", "derin öğrenme", "tıbbi görüntüleme"],
    "authors": [
      { "orcid": "0000-0002-1825-0097", "institution": "Hacettepe University" },
      { "institution": "Başkent University", "rorId": "https://ror.org/02v9bqx10" }
    ],
    "maxResults": 10
  }'

Yanıt gövdesi

Alan Tür Açıklama
searchId zorunlu uuid Aramanın kimliği. Davetler buna dayanmalıdır.
expiresAt zorunlu date-time Bu aramadan ne zamana kadar davet gönderilebileceği (30 gün).
results[].reviewerCode zorunlu string Hakemin derginize özel takma kodu, örneğin SV-7KQ2MX4P.
results[].rank zorunlu integer Listedeki sırası, 1'den başlar.
results[].score zorunlu number 0–100 arası uyum skoru: uzmanlık; iş yükü, zamanında tamamlama, dinlenme süresi ve son retlere göre düzeltilir.
results[].matchedTerms zorunlu string[] Makalenizden profille eşleşen en fazla beş terim, sizin yazdığınız biçimde.
results[].academicTitle string | null Hakem belirttiyse akademik unvanı.
results[].verifiedReviews zorunlu integer Hakemin doğrulanmış hakemlik sayısı: Scholvet üzerinden, dergilerin onayladığı ya da bir yayıncı veya hakemlik hizmetinin ORCID'e yazdığı. Yalnızca sayıdır; dergi ya da tarih vermez.
excludedCount zorunlu integer Çıkar çatışması, iş yükü ya da müsait olmama nedeniyle listelenmeyen hakem sayısı.
Yanıt
HTTP/1.1 201 Created
Location: /v1/reviewer-searches/0b4f6c1e-5c1a-4a7e-9d0f-7f1c2a9e3b55

{
  "searchId": "0b4f6c1e-5c1a-4a7e-9d0f-7f1c2a9e3b55",
  "expiresAt": "2026-11-27T09:14:02Z",
  "results": [
    {
      "reviewerCode": "SV-7KQ2MX4P",
      "rank": 1,
      "score": 95.2,
      "matchedTerms": ["derin öğrenme", "medical imaging", "convolutional neural networks"],
      "academicTitle": "Prof. Dr.",
      "verifiedReviews": 23
    },
    {
      "reviewerCode": "SV-JRWAM9F8",
      "rank": 2,
      "score": 58.0,
      "matchedTerms": ["deep learning", "detection"],
      "academicTitle": "Assoc. Prof.",
      "verifiedReviews": 4
    }
  ],
  "excludedCount": 3
}

Bilmekte yarar var

Sonraki: Davetler →