创建空记录

1.  接口描述

电子实验记录本创建空白记录API接口,使用JSON格式进行数据交换。

在调用API时,在Header里要加入如下的信息:

Authorization: Bearer {AccessToken}

AccessToken 的获取方式,见“认证接口”

2.  接口调用

请求URL: https://eln.iphy.ac.cn:61262/eln_api/create

参数

eln 必填,字符串。要导入的记录本名称;
user 选填。字符串。如果是自己的记录本,可不填写;他人的合作编辑记录本,需要填写记录本所有者的Email
path 选填。字符串数组列表。表示数据所在的子分类。路径依次为1级分类,2级分类...;
title 必填。字符串。记录名称;
uid 选填。字符串。唯一标式,如果不填则由系统随机创建;
describe 选填。字符串。html 格式的描述信息;

示例

{
    "eln": "记录本名称",
    "user": "xxx@abc.com",
    "path": ["level1","level2","level3"],
    "title": "记录本名称",
    "uid": "uid",
    "describe": "html 格式描述信息"
}

3.  返回信息

code 错误代码;
  • 0: 成功;
  • 1: 认证 Token 信息无效;
  • 2: 数据格式错误;
  • 3: 服务器原因错误;
  • 'refresh': 认证 Token 过期,需使用刷新Token重新获取。
msg 错误描述;

返回错误示例

{
    "code": 2,
    "msg": "标题不能为空"
}

返回成功示例

{
    "code": 0,
    "msg": "记录创建成功"
}