首页 > 开放平台 > 电子合同(标准签) > 其它接口
开放平台/其它接口/关键字定位接口

关键字定位接口

2026-09-24 更新 阅读 版本 v1.0

接口说明

关键字定位,返回文件上该关键字的中心点坐标(X,Y),若要将印章中心加盖在关键字中心上,则印章的坐标传值建议为(X-1/2章图片宽,Y-1/2章图片高)。

API 方法名:nuonuo.electronicContract.keyWordPosition 版本:V2.0

请求地址

环境请求地址
正式环境https://sdk.nuonuo.com/open/v1/services
沙箱环境https://sandbox.nuonuocs.cn/open/v1/services

公共请求参数(消息头)

参数名类型必填长度说明示例
Content-typeString否-MIME类型【消息头】-

公共请求参数(消息体)

参数名类型必填长度说明示例
senidString否-唯一标识,由企业自己生成32位随机码【消息体】-

私有请求参数

参数名类型必填长度说明示例
base64FileStrString否-pdf/doc/docx文件的base64文件流
keyWordsString否10关键字签署位置
pageNumsArray否-关键字页数[1,2,3]

响应参数

参数名类型必填长度说明示例
codeString否-H200
describeString否-成功
resultObject否--
   └ resultStringString否-关键字描述第1页--第1个关键字x:218.465、y:698.5399。--第2个关键字x:265.265、y:698.5399。--第3个关键x:283.505、y:698.5399
resultListArray否-关键字具体X,Y位置列表-
   └ xNumber否-X轴坐标218.465
   └ yNumber否-Y轴坐标698.5399
   └ pageNumNumber否-关键字所在页数1

请求报文示例

NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.electronicContract.keyWordPosition"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
  \"keyWords\": \"签署位置\",
  \"base64FileStr\": \"pdf/doc/docx文件的base64文件流\",
  \"pageNums\": [
    \"[1\",
    \"2\",
    \"3]\"
  ]
}";
String url = "https://sdk.nuonuo.com/open/v1/services"; // SDK请求地址
String senid = UUID.randomUUID().toString().replace("-", ""); // 唯一标识,32位随机码,无需修改,保持默认即可
String result = sdk.sendPostSyncRequest(url, senid, appKey, appSecret, token, taxnum, method, content);
System.out.println(result);

返回码说明

返回码说明处理建议
H200成功
标签: 开放平台
已经是第一篇
已经是最后一篇

申请试用

请留下您的联系方式,我们将在一个工作日内与您联系