# 中国科技manbetx官网入口源ManbetX.com科技manbetx官网入口源信息汇交接口文档

本文档介绍科技manbetx官网入口源汇交、新闻提交等ManbetX.com开放接口交互操作流程。

# 科技manbetx官网入口源信息汇交开放接口处理流程

# 第一步. 国家平台管理员创建具有元数据汇交权限的账号

国家平台管理员需要创建用于科技manbetx官网入口源信息汇交的角色,该角色至少需要拥有“manbetx官网入口源管理-元数据汇交”权限。只有拥有此权限的用户才可以进行科技manbetx官网入口源信息汇交操作

# 第二步. 申请用于机器交互的应用ID和应用CS

在使用开放接口模式进行元数据汇交之前,需要申请符合条件的客户端。

注意:ManbetX.com试运行期间,可直接联系管理员获取应用ID和应用CS。

申请流程为:

  1. 国家平台管理员增加“终端管理”功能;
  2. 申请应用ID和应用CS;
    a) 进入后台管理系统的【第三方应用】=>【应用管理】页面,点击终端管理--创建应用,在弹出的对话框中填写网站或应用的详细manbetx官网入口料(应用名称,应用主页,回调地址);
    b) 点击“确定”按钮,提交manbetx官网入口料后,获取应用ID和应用CS

用于元数据汇交的应用需要满足以下条件:

  • scope固定值应为metadata_add
  • GranTypes应为password

对于开放接口汇交,仅上述信息有效,其他信息不做限制。

图 创建新应用图

# 第三步.获取access_token

为简化使用流程,开放接口模式进行科技manbetx官网入口源信息汇交的认证模式采用Oauth2的password模式。 具有相应权限的使用者直接使用账号密码信息即可获得对应的access token,并持此token调用科技manbetx官网入口源信息汇交开放接口。

access token由每次用户登录时生成,过期时间默认为三个月。应用程序应自动使用oauth2的refresh code模式获取新的access token或申请新的access token。

请求地址: https://oauth.5ymj6.com/oauth/token

请求方法:POST

请求参数:

参数名称 解释
client_id 在ManbetX.com上注册用户创建的第三方应用。
client_secret 在ManbetX.com上注册用户创建的第三方应用中获取。
username ManbetX.com用户名
password ManbetX.com密码
grant_type 固定值为password
scope 固定值为metadata_add

返回参数:

参数名称 解释
access_token 第三方网站访问用户在ManbetX.com上manbetx官网入口源的凭证
token_type 此处固定为“bearer”
expires_in 过期时间,单位是秒(s)
scope 在ManbetX.com申请ClientID时填写的授权范围
license 此处固定为made by escience
jti 请求的id

# 第四步.调用汇交开放接口

调用汇交开放接口进行汇交需要提供access_token、clientId和元数据三部分内容。

请求地址:https://api.5ymj6.com/cstr/metadata/record/edit

请求方法:POST PUT DELETE

分别对应新增、修改和删除操作

请求参数:

参数需添加在Header中,应包含如下内容:

参数名称 解释
clientId 申请的应用ID
Authorization token_type +一个英文空格+access_token
access_token为从ManbetX.com获取的access_token。
Bearer和access_token中间有一个空格

请求主体:

请求主体内容(Body)应包含JSON形式的科技manbetx官网入口源信息,具体格式如下所示。删除时仅需id信息。

{
    "chineseTitle": "LAMOST光谱巡天第二次数据发布",
    "englishTitle": "LAMOST Data Release 2",
    "id": "100003",
    "subjectCategory": "天文学",
    "themeCategory": "光学波段数据 天文光谱 LAMOST望远镜",
    "keyword": "巡天;光谱;星表",
    "description": "LAMOST第二次巡天数据发布(DR2)包括有先导巡天和前两年巡天的光谱数据,观测时间自2011年10月24日开始,到2014年6月5日结束,共观测1934个天区,获得3,274,369条信噪比大于10的恒星光谱。DR2共释放光谱数共计4,132,782,其中还包括220万颗恒星光谱参数星表。这是目前世界上获取的最大参数星表。",
    "serviceOrganizationName": "国家天文科学数据中心",
    "serviceOrganizationAddress": "北京市朝阳区大屯路甲20号 国家天文台",
    "serviceOrganizationPostalCode": "100101",
    "serviceOrganizationPhoneNumber": "(010)64807973",
    "serviceOrganizationMail": "[email protected]",
    "date": "2016-06-30",
    "sharingMode": {
        "sharePathway": [
            "线上共享"
        ],
        "shareScope": "完全共享",
        "applicationProcess": "在线开放"
    },
    "onlineAddress": "https://dr2.lamost.org",
    "extra": {
        "extend1": "extend value1",
        "extend2": "extend value2"
    }
}

调用此接口提交的数据必须符合汇交规范,经过校验且通过的数据将会存放在待提交的变更中,等待报送审核或进一步修改。

校验通过返回的信息格式如下:

{
    "code": 200,
    "msg": "success",
    "data": true
}

校验不通过返回的信息格式如下:

{
    "code": 1,
    "msg": "校验不通过",
    "data": {
        "errors": [
            "中文名称不能为空",
            "共享途径字段错误",
            "邮政编码必须为六位的数字"
        ],
        "success": false,
        "errorNumber": 3
    }
}

# 联系人员

姓名 电话 邮箱
侯笛 010-82339102 [email protected]