公证查询

POST /openapi/v1/notary/orders/query

按 notaryOrderNo 或 externalOrderNo(二选一)查询公证订单当前状态。

请求

字段	必填	说明
notaryOrderNo	△	cxh 公证订单号(64 位 ID 字符串);与 externalOrderNo 二选一必填
externalOrderNo	△	渠道侧订单号,与下单入参一致;与 notaryOrderNo 二选一必填

二字段都为空时返回 404001 RESOURCE_NOT_FOUND。

响应

响应字段结构与 公证下单 一致。

公证函就绪检查

当 status 为 SUCCESS 但 certificateAccessUrl 为空时,公证函可能仍在生成中,渠道应稍后重试查询。本接口在每次查询时都会自动尝试一次刷新,刷新成功后即返回完整的 certificateAccessUrl。

错误码

code	含义
404001 RESOURCE_NOT_FOUND	订单不存在或不属于当前渠道
403001 NO_PERMISSION	渠道未授权公证服务

详见 错误码。

---

公证函下载

调本接口拿到 certificateAccessUrl 后,直接 GET 该 URL 即可下载公证函 PDF。

GET https://api.cxh.me/notary-cert/access?notaryOrderNo=...&appId=...&exp=...&sig=...

(沙箱域名 test-api.cxh.me。)

• URL 由 cxh 颁发,默认 7 天有效
• URL 过期后,重新调本接口或 公证下单 拿新 URL 即可,无需特殊刷新流程

响应判定

通过 Content-Type 区分成功 / 失败:

• application/pdf + HTTP 200 — 成功,响应体为公证函 PDF 字节流
• application/json — 失败,响应体为 JSON 错误结构,按 code 字段分支处理

完整错误码与 HTTP 状态码对应见 错误码 § 公证函下载路径错误码。