接口文档 · 预评估提交
请求地址
- 方法：
POST。推荐请求头Content-Type: application/json、Accept: application/json。 - 示例完整地址（与当前环境一致时可直接使用）：
https://admin.cpservice.cn/api/patentpreeval/submit - 实际联调地址以本页上方「提交接口地址」为准；若站点部署在其它域名或子路径，请替换协议与主机名，路径保持
/api/patentpreeval/submit。
接收参数（业务 JSON，与鉴权字段同一次请求发送）
- tel
- 大陆手机号，11 位数字，提交预评估时必填。
- title
- 专利标题，字符串，必填。
- applicant
- 申请人，字符串，必填。
- claim
- 权利要求书文本，字符串，必填。
- fullText
- 说明书全文，字符串，必填。
- appDate
- 申请日由服务端按「当天」自动填写，客户端可不传。
鉴权参数（逐项说明）
下列字段须同时参与验签；可放在 JSON body 中，也可与 body 并列通过 HTTP 头传递（头名大小写不敏感，常用写法如下）。
- platform（鉴权用）
- 平台标识字符串，用于拼接待验签明文；格式须满足服务端规则（约 2～64 位，字母数字及
_-.）。与请求头X-Platform及 body 中同名字段应一致。 - ts
- Unix 时间戳（秒），字符串形式、固定 10 位十进制数字。服务端会校验与服务器当前时间的偏差，不得超过环境变量
preeval.sign_ttl指定的秒数（常见为 300 秒），否则返回过期。 - nonce
- 一次性随机串，建议 8～64 位「字母 + 数字」；同一
platform+nonce+ts在 TTL 内不可重复使用，否则视为重放攻击。 - sign
- 签名字符串，为 64 位十六进制（对 SHA-256 摘要的十六进制表示，大小写服务端均接受）。计算方式：先构造明文
plain = platform + '|' + ts + '|' + nonce + '|' + secret，再sign = SHA256(plain)转为十六进制字符串。 - secret（仅服务端与本页本地）
- 对应部署环境
.env中的preeval.api_key。仅保存在服务器；客户端绝不把 secret 当作 HTTP 参数对外发送，只在本调试页输入用于在浏览器内算出sign。 - X-Platform
- 可选请求头，值与 body 中的
platform相同，便于网关或日志只读头字段完成鉴权。 - X-Ts
- 可选请求头，值与 body 中的
ts相同。 - X-Nonce
- 可选请求头，值与 body 中的
nonce相同。 - X-Sign
- 可选请求头，值与 body 中的
sign相同。
接口文档 · 预评估报告下载
请求地址
- 方法：
POST，Content-Type: application/json。 - 示例完整地址：
https://admin.cpservice.cn/api/patentpreeval/downloadReportByTask - 实际地址以本页「下载接口地址」为准；路径固定为
/api/patentpreeval/downloadReportByTask。
接收参数（业务 JSON）
- platform（业务字段）
- 任务所属业务平台标识，与本地库 / CNIPR 中该任务记录上的平台一致，用于和
task一起定位一条预评估任务。可与下方鉴权用的platform不同（例如鉴权用h5-demo，业务平台为cqlg）。 - task
- CNIPR 返回的任务号字符串；与本页输入框「平台/任务号」中斜杠后面的部分一致（若任务号本身含斜杠，则斜杠前为业务 platform，其后全部为 task）。
鉴权参数（逐项说明，算法与预评估提交相同）
用于计算 sign 的 platform、ts、nonce 取自本页「鉴权 platform」及随机生成逻辑；它们与 JSON 里的业务 platform（任务归属）是两套概念，请勿混淆。
- platform（鉴权用）
- 参与
plain = platform + '|' + ts + '|' + nonce + '|' + secret的平台名；须与请求头X-Platform（若使用）及 body 内鉴权字段一致。 - ts
- 同上，10 位 Unix 秒数字符串，在
preeval.sign_ttl允许范围内。 - nonce
- 同上，防重放的一次性随机串。
- sign
- 同上，对 plain 做 SHA-256 后的 64 位十六进制字符串。
- secret
- 同上，对应服务端
preeval.api_key，仅本页本地输入用于算签。 - X-Platform / X-Ts / X-Nonce / X-Sign
- 可选；值分别与 body 中鉴权四字段一致，便于与预评估提交接口保持同一调用习惯。
接口文档 · 价值评估查询
请求地址
- 方法：
POST（服务端亦允许GET）；推荐Content-Type: application/json。 - 示例完整地址（与后台注入默认一致时可作为参考）：
https://admin.cpservice.cn/api/patentvaluescore/query - 实际上线域名可能不同，请以本页「价值评估查询接口地址」输入框为准；路径为
/api/patentvaluescore/query。
接收参数（业务）
- pns
- 专利申请号字符串，长度与格式须通过服务端校验；上游按申请号查询，且固定 isan=ON。
- tel
- 大陆手机号，11 位数字，必填；用于服务端风控与日志关联。
鉴权参数（逐项说明，与预评估为同一套签名规则）
价值评估查询与下载均使用 preeval.api_key 作为签名密钥来源（环境变量名相同），与预评估提交/下载一致。
- platform（鉴权用）
- 平台标识；参与
plain = platform + '|' + ts + '|' + nonce + '|' + secret；与X-Platform及 body 中字段保持一致。 - ts
- 10 位 Unix 秒数字符串；超出
preeval.sign_ttl窗口即失败。 - nonce
- 一次性随机串；在缓存 TTL 内重复使用同一组合会判为重放。
- sign
- 对 plain 做 SHA-256 后的 64 位十六进制摘要字符串。
- secret
- 服务端
.env→preeval.api_key；仅用于本地算签，勿随请求明文外传。 - X-Platform
- 可选；与鉴权
platform同值。 - X-Ts
- 可选；与
ts同值。 - X-Nonce
- 可选；与
nonce同值。 - X-Sign
- 可选；与
sign同值。
调用上游前，服务端还需在 application/extra/cnipr.php 对应环境或 .env 的 [cnipr] 中配置专利价值评分相关项（如 score_api_key、score_secret_key），否则上游会返回配置类错误。
接口文档 · 价值评估报告下载
请求地址
- 方法：
POST；请求体为 JSON；成功时常返回application/pdf二进制流。 - 示例完整地址（在查询域名为
admin.cpservice.cn时与「由 query 替换为 downloadreport」一致）：https://admin.cpservice.cn/api/patentvaluescore/downloadreport - 实际地址以本页「价值评估报告下载接口地址」为准；路径为
/api/patentvaluescore/downloadreport。
接收参数（业务）
- tel
- 大陆手机号，11 位数字，必填。
- pn
- 公告号一种写法，与
pub_no、ggno择一即可，勿与查询接口的申请号pns混用。 - pub_no
- 公告号字段别名，语义同
pn。 - ggno
- 公告号另一别名，服务端解析公告号时三选一即可。
- force（可选）
- 布尔或
0/1；为真时跳过已有缓存文件、强制从上游重拉并覆盖本地 PDF。
鉴权参数（逐项说明）
与「价值评估查询」及预评估接口使用相同的 plain 与 SHA-256 规则；其中鉴权字段 platform 还会参与服务端生成/查找本地缓存目录（按平台分目录落盘）。
- platform（鉴权用）
- 用于签名及缓存分区；须与
X-Platform（若使用）及 body 内鉴权字段一致。 - ts
- 10 位 Unix 秒数字符串，在 TTL 内有效。
- nonce
- 一次性随机串，防重放。
- sign
SHA256(platform + '|' + ts + '|' + nonce + '|' + secret)的十六进制字符串。- secret
- 服务端
preeval.api_key；本页仅本地算签。 - X-Platform
- 可选；与鉴权
platform同值。 - X-Ts
- 可选；与
ts同值。 - X-Nonce
- 可选；与
nonce同值。 - X-Sign
- 可选；与
sign同值。