# 中国科技manbetx官网入口源ManbetX.com科技manbetx官网入口源信息汇交接口文档
本文档介绍科技manbetx官网入口源汇交、新闻提交等ManbetX.com开放接口交互操作流程。
# 科技manbetx官网入口源信息汇交开放接口处理流程
# 第一步. 国家平台管理员创建具有元数据汇交权限的账号
国家平台管理员需要创建用于科技manbetx官网入口源信息汇交的角色,该角色至少需要拥有“manbetx官网入口源管理-元数据汇交”权限。只有拥有此权限的用户才可以进行科技manbetx官网入口源信息汇交操作
# 第二步. 申请用于机器交互的应用ID和应用CS
在使用开放接口模式进行元数据汇交之前,需要申请符合条件的客户端。
注意:ManbetX.com试运行期间,可直接联系管理员获取应用ID和应用CS。
申请流程为:
- 国家平台管理员增加“终端管理”功能;
- 申请应用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] |