用户须知

用于CSTR标识注册,支持科学数据、期刊论文、专利、软著、预印本、仪器设备、学位论文7种元数据模板。若您不清楚,请邮件联系管理员(cstr@cnic.cn

SDK源码预览及下载: https://gitee.com/datapid/pid-sdk-java.git

请求地址

环境 HTTPS请求地址 Method
正式环境 https://www.cstr.cn/openapi/v2/pid-common-service/registerIdentity/batch.register/{type} POST
沙盒环境 https://www.cstr.cn/sandbox/openapi/v2/pid-common-service/registerIdentity/batch.register/{type} POST

请求参数中的{type}为标识元数据模板类型,取值范围

序号 type 描述
1 commondata 科学数据
2 journal 期刊论文
3 patent 专利
4 sftcopyright 软著
5 preprint 预印本
6 equipment 仪器设备
7 dissertation 学位论文

公共请求参数 Header 传参

参数 类型 是否必填 最大长度 描述 示例值
clientId String 32 分配给开发者的应用ID 2014072300007148
secret String 32 密钥 32位长度字符串

参数详情

Body 请求参数为标识元数据,格式为xml或JSON,元数据说明详见如下

序号 元数据模板类型 描述 资源链接
1 commondata 科学数据 科学数据
2 journal 期刊论文 期刊论文
3 patent 专利 专利
4 sftcopyright 软著 软著
5 preprint 预印本 预印本
6 equipment 仪器设备 仪器设备
7 dissertation 学位论文 学位论文

公共响应参数

参数 类型 是否必填 最大长度 描述 示例值
code int - 网关返回状态码 200
message String - 网关返回码描述信息 标识注册失败
timestamp String - 时间戳,参见具体的API接口文档 2021-04-06 10:06:35
data Map - 业务返回数据,参见响应参数 字符串,对象

请求参数示例

序号 元数据模板类型 描述 资源链接
1 commondata 科学数据 《科学数据-参数示例》
2 journal 期刊论文 《期刊论文-参数示例》
3 patent 专利 《专利-参数示例》
4 sftcopyright 软著 《软著-参数示例》
5 preprint 预印本 《预印本-参数示例》
6 equipment 仪器设备 《仪器设备-参数示例》
7 dissertation 学位论文 《学位论文-参数示例》

请求示例

响应实例

异常示例

状态代码

状态码 描述 解决方案
200 注册成功
400 请求参数错误 请检查请求参数格式,是否为合法XML或JSON
500 标识注册异常 根据返回的参数验证失败信息,修改后重新发起请求