# 中国科技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]