Для удобства получения данных об изданиях, входящих в «Белый список», система предоставляет открытый API.
Предлагаемый API использует при выгрузке данных удобный для последующей машинной обработки формат JSON.
Выгружаемые текстовые данные имеют кодировку UTF-8.
Основной URL для всех запросов к API: https://journalrank.rcsi.science/api
.
Для получения данных об уровне журнала в «Белом списке» по ISSN необходимо выполнить запрос вида https://journalrank.rcsi.science/api/record-sources/{issn}/level
.
Где в качестве параметра {issn}
необходимо указать ISSN журнала.
Результат:
HTTP-статус | Данные |
---|---|
200 | JSON-объект с данными об уровне журнала в «Белом списке» |
400 | Журнал с указанным ISSN не найден |
Описание возвращаемого JSON-объекта:
{
"$id": "record-source-level",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"title": "Данные об уровне журнала в «Белом списке»",
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "Идентификатор журнала",
},
"url": {
"type": "string",
"description": "Фрагмент URL карточки журнала",
},
"title": {
"type": "array",
"description": "Название журнала",
"items": {
"type": "string"
}
},
"issn": {
"type": "array",
"description": "ISSN журнала",
"items": {
"type": "string"
}
},
"level": {
"type": "integer",
"description": "Уровень журнала в «Белом списке»",
"enum": [ 1, 2, 3, 4 ]
},
"state": {
"description": "Тип отметки",
"type": [
"string",
"null"
]
},
"notice": {
"description": "Примечание",
"type": [
"string",
"null"
]
},
"dateAccepted": {
"description": "Дата включения в «Белый список»",
"type": "string"
},
"dateDiscontinued": {
"description": "Дата исключения из «Белого списка»",
"type": [
"string",
"null"
]
}
}
}
Пример ответа для запроса https://journalrank.rcsi.science/api/record-sources/2079-3537/level
:
{
"id": 28418,
"url": "/record-sources/details/28418/",
"title": [
"НАУЧНАЯ ВИЗУАЛИЗАЦИЯ",
"SCIENTIFIC VISUALIZATION"
],
"issn": [
"2079-3537"
],
"level": 3,
"state": null,
"notice": null,
"dateAccepted": "2022-10-20",
"dateDiscontinued": null
}