Başlarken

Yayın sisteminizi Scholvet ile bütünleştirmek

Scholvet, dergi yönetim sistemlerine nitelikli hakem bulmak, onları gizlilik içinde davet etmek ve yanıtlarını almak için tek bir API sunar. Bu kılavuz, ilk istekten webhook doğrulamaya kadar bir entegrasyonun ihtiyaç duyduğu her şeyi anlatır.

Bir bakışta entegrasyon

Ara. Makalenin başlığını, özetini, anahtar kelimelerini ve yazarların kurumlarını gönderin. Uyum skoruyla sıralanmış hakem kodları alırsınız.
Davet et. O aramadaki bir ya da birkaç kodu davet edin. Scholvet hakemi e-postayla ve panelinden bilgilendirir.
Dinle. Hakemin yanıtını webhook adresinizde alın ya da gerektiğinde daveti sorgulayın.
Ata. Hakem kabul edince davet; adını, e-postasını, ORCID kimliğini ve kurumunu taşır. Hakemi kendi sisteminizde atayın.
Onayla. Değerlendirme tamamlanınca onaylayın. Hakemin emeği bu onayla kayda geçer.

Temel bilgiler

Biçim: İstek ve yanıtlar UTF-8 JSON. Alan adları camelCase. Hatalar application/problem+json biçiminde.
Zamanlar: UTC olarak ISO 8601, örneğin 2026-10-28T09:20:11Z.
Kimlik doğrulama: Her dergiye ayrı bir API anahtarı; X-Api-Key başlığında gönderilir.

Ortamlar

Tek ortam vardır: canlı. Şu an ayrı bir test ortamı sunulmuyor. Aramaların yan etkisi yoktur ve ücretsizdir; entegrasyonunuzu bunlarla kurup deneyin. Davetleri yalnızca gerçek makaleler için gönderin; yanlışlıkla gönderdiğinizi POST /v1/invitations/{id}/cancel ile hemen geri çekin.

Ortam	Temel adres	Anahtarlar	Anlamı
Canlı	`https://api.scholvet.com/v1`	`sv_live_…`	Gerçek hakemler ve gerçek davetler.

Erişim almak

Kurumlar console.scholvet.com adresinde kaydolur ve API anahtarını hemen alır. Scholvet kurumu doğrulayıp paketini etkinleştirene kadar anahtar aramalarda çalışır; ardından davetler açılır. Birçok dergiyi barındıran bir sistem (dergi yönetim platformu) her dergiyi onu yayımlayan kurumun altına kaydeder.

Konsolu aç

Hızlı başlangıç

Örnekler canlı adresi kullanır.

1. Anahtarınızın çalıştığını doğrulayın. Yanıt, anahtarın ait olduğu dergiyi gösterir.

İstek

curl https://api.scholvet.com/v1/me \
  -H "X-Api-Key: $SCHOLVET_API_KEY"

Yanıt

{
  "id": 42,
  "name": "Journal of Medical Imaging Research",
  "issn": "1234-5678",
  "webhookConfigured": true
}

2. Bir makale için hakem arayın.

İ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
  }'

3. Arama sonucundaki bir hakemi davet edin.

İstek

curl -X POST https://api.scholvet.com/v1/invitations \
  -H "X-Api-Key: $SCHOLVET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "searchId": "0b4f6c1e-5c1a-4a7e-9d0f-7f1c2a9e3b55",
    "reviewerCode": "SV-7KQ2MX4P",
    "externalRef": "your-invitation-881",
    "articleTitle": "Deep learning for tumour detection in brain MRI",
    "articleAbstract": "We evaluate convolutional neural networks...",
    "message": "We would value your opinion on this manuscript.",
    "respondByDays": 7,
    "reviewDays": 21
  }'

4. Yanıtı alın: Webhook'lar

Sonraki: Kimlik doğrulama ve sınırlar →