بین‌کاو۱. پیش از پر کردن فرم
- کلید رایگان است و فقط برای پژوهش و آموزش غیرتجاری صادر می‌شود. کلید شخصی شماست و فقط برای جست‌وجوهای خودتان به کار می‌رود.
- بدون کلید هم جست‌وجو کار می‌کند: OpenAlex، Crossref و Europe PMC به کلید نیاز ندارند. کلید Semantic Scholar فقط یک پایگاه دیگر اضافه می‌کند.
- ایمیل دانشگاهی یا سازمانی آماده داشته باشید. Semantic Scholar درخواست‌های مؤسسه‌های پژوهشی و دانشگاهی را در اولویت قرار می‌دهد.
- یک درخواست بدون کلید بفرستید (بخش ۵ همین راهنما)، زیرا فرم تأیید این کار را می‌خواهد.
۲. مشخصات شما
نام و نام خانوادگی را با حروف انگلیسی، همان‌گونه که در صفحهٔ دانشگاه یا مقاله‌هایتان آمده است، بنویسید.
ایمیل دانشگاهی یا سازمانی. کلید به همین نشانی فرستاده می‌شود و درخواست‌های با ایمیل‌های رایگان (مانند Gmail یا Yahoo) ممکن است پذیرفته نشوند.
نام کامل و رسمی دانشگاه یا مؤسسه به انگلیسی، بدون کوته‌نوشت؛ یعنی University of Tehran و نه UT. اگر پژوهشگر مستقل هستید، Independent researcher بنویسید.
نشانی وب‌سایت رسمی همان مؤسسه؛ ترجیحاً صفحهٔ دانشکده یا صفحهٔ شخصی شما در وب‌سایت دانشگاه.
کشوری که در آن زندگی یا کار می‌کنید، از فهرست. اطلاعات را درست وارد کنید؛ Semantic Scholar درخواست‌ها را مطابق قوانین حاکم بر خود بررسی می‌کند و ممکن است درخواست برخی کشورها را نپذیرد.
این خانه فقط برای ساکنان اوکراین است. در غیر این صورت آن را خالی بگذارید.
۳. نوع استفاده و شرح پروژه
Private را انتخاب کنید: کلید را خودتان و فقط برای پژوهش خودتان به کار می‌برید. گزینهٔ Public (Free / Nonprofit) برای کسانی است که یک سرویس عمومی برای دیگران راه‌اندازی می‌کنند.
دست‌کم ۵۰ واژه به انگلیسی بنویسید: شما که هستید، کلید را در چه برنامه‌ای و برای چه کاری به کار می‌برید، از کدام نقطهٔ دسترسی (endpoint) و کدام فیلدها استفاده می‌شود، روزانه چند درخواست می‌فرستید و چگونه از فشار بر سرورها جلوگیری می‌کنید. متن نمونهٔ زیر همهٔ این موارد را پوشش می‌دهد؛ رشته، دانشگاه و نقش خود را جایگزین کنید.
I am a PhD student in cognitive neuroscience at the University of Tehran. I will use my key only for my own non-commercial research, in Binkav, a desktop application for literature search. It calls the paper relevance search endpoint (/graph/v1/paper/search) with the fields title, abstract, year, venue, authors, externalIds, citationCount, openAccessPdf and tldr. It sends one request per search, about 50 to 150 requests per day, never more than one request per second, with exponential backoff on errors. Results are shown only to me and are not stored or shared publicly.
۴. نقطه‌های دسترسی و تعداد درخواست
بین‌کاو فقط از نقطهٔ دسترسی جست‌وجوی مقاله استفاده می‌کند: برای هر جست‌وجوی شما یک درخواست.
هر جست‌وجو در بین‌کاو یک درخواست به Semantic Scholar می‌فرستد. عددی متناسب با کار خود بنویسید؛ برای بیشتر پژوهشگران ۵۰ تا ۱۵۰ کافی است. بین‌کاو درخواست‌ها را خودکار با فاصلهٔ دست‌کم ۱٫۱۵ ثانیه می‌فرستد، پس از سقف یک درخواست در ثانیه فراتر نمی‌رود.
۵. پنج تأییدیهٔ پایان فرم
| تأییدیه | معنا و کاری که باید انجام دهید |
|---|---|
| I have already successfully made unauthenticated requests | یعنی API را بدون کلید آزموده‌اید. برای این کار کافی است نشانی زیر را در مرورگر باز کنید؛ اگر فهرستی از مقاله‌ها (با قالب JSON) دیدید، درخواست بدون کلید موفق بوده است:https://api.semanticscholar.org/graph/v1/paper/search?query=working+memory&limit=3 |
| I acknowledge that there are only 2 rate plans | کلیدها با سقف مقدماتی یک درخواست در ثانیه صادر می‌شوند و سقف بالاتر فقط با درخواست جداگانه داده می‌شود. برای استفادهٔ شخصی در بین‌کاو، همان سقف مقدماتی کافی است. |
| I will apply exponential backoff and similar strategies… | یعنی اگر سرور درخواستی را رد کرد، با فاصله‌های فزاینده دوباره تلاش می‌کنید. بین‌کاو این کار را خودکار انجام می‌دهد و درخواست‌ها را زیر سقف مجاز نگه می‌دارد. |
| I understand that keys that are seen to be inactive for approximately 60 or more days may be removed | اگر حدود ۶۰ روز از کلید استفاده نشود، ممکن است غیرفعال شود. در این صورت فرم را دوباره بفرستید. |
| I have read and agree to Semantic Scholar™ API License Agreement | توافق‌نامه را بخوانید؛ مهم‌ترین نکته‌اش استفادهٔ غیرتجاری و منتشر نکردن دوبارهٔ داده‌ها و کلید است. |
سپس فرم را بفرستید.
۶. پس از ارسال و وارد کردن کلید
- منتظر ایمیل بمانید. زمان بررسی مشخص نیست و ممکن است چند روز تا چند هفته طول بکشد. پوشهٔ هرزنامه را نیز بررسی کنید. اگر پس از دو هفته خبری نشد، فرم را دوباره بفرستید.
- در بین‌کاو به «تنظیمات ← منابع» بروید، گزینهٔ «جست‌وجو در Semantic Scholar هم با کلید خودم» را علامت بزنید، کلید را در کادر بچسبانید و «ذخیره» را بزنید.
- از این پس، نتایج Semantic Scholar نیز در جست‌وجوها ادغام می‌شوند. هر جست‌وجو حدود یک ثانیه طولانی‌تر می‌شود.