diff --git a/api-web/api-interface/src/main/java/com/heyu/api/controller/certificate/Factors3VerificationController.java b/api-web/api-interface/src/main/java/com/heyu/api/controller/certificate/Factors3VerificationController.java index a0c73ad..8bb085b 100644 --- a/api-web/api-interface/src/main/java/com/heyu/api/controller/certificate/Factors3VerificationController.java +++ b/api-web/api-interface/src/main/java/com/heyu/api/controller/certificate/Factors3VerificationController.java @@ -14,17 +14,53 @@ import org.springframework.beans.factory.annotation.Autowired; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; -/*** - * https://console.bce.baidu.com/support/?_=1740219852952×tamp=1742615758969#/api?product=AI&project=%E6%96%87%E5%AD%97%E8%AF%86%E5%88%AB&parent=%E5%8D%A1%E8%AF%81OCR&api=rest%2F2.0%2Focr%2Fv1%2Fthree_factors_verification&method=post - * - * 企业三要素核验 - * - * - * 接口描述 - * 通过核验企业名称、统一社会信用代码、法人姓名一致性，快速核验企业资质。 - * - * 注：目前支持工商注册的企业认证，事业单位、律师事务所等信息暂不支持验证，发生工商变更或刚注册的企业信息，预计在企业公示的核准日期T+3个工作日后可进行验证。 +/** + * 企业三要素核验控制器 + *

+ * 基于百度 OCR API，对企业三要素信息进行核验，验证企业资质的真实性。 + * 通过核验企业名称、统一社会信用代码、法人姓名的一致性，快速完成企业身份认证。 + *

+ *

+ * 核验要素： + *

+ *

+ *

+ * 核验结果字段： + *

+ *

+ *

+ * 注意事项： + *

+ *

+ *

+ * 适用场景： + *

+ *

+ *

+ * 接口路径：/factors3/recognize + *

* + * @author heyu + * @since 1.0.0 */ @Slf4j @RestController @@ -35,6 +71,20 @@ public class Factors3VerificationController extends BaseController { @Autowired private BThreeFactorsVerificationHandle bFourFactorsVerificationHandle; + /** + * 企业三要素核验接口 + *

+ * 接收企业三要素信息，调用百度 API 进行一致性核验。 + * 返回核验结果包括整体验证结果及各字段的匹配状态。 + *

+ * + * @param request 企业三要素核验请求参数，包含： + * - companyName：企业名称 + * - regNum：统一社会信用代码 + * - legalPerson：法人姓名 + * @return 核验结果，包含 verifyresult（核验结果）、namematch（名称匹配）、 + * companymatch（企业匹配）、regnummatch（代码匹配） + */ @RequestMapping("/recognize") @CacheResult public R recognize(BFourFactorsVerificationRequest request) { diff --git a/api-web/api-interface/src/main/java/com/heyu/api/controller/certificate/SocialSecurityCardController.java b/api-web/api-interface/src/main/java/com/heyu/api/controller/certificate/SocialSecurityCardController.java index 0ced79a..54cad8b 100644 --- a/api-web/api-interface/src/main/java/com/heyu/api/controller/certificate/SocialSecurityCardController.java +++ b/api-web/api-interface/src/main/java/com/heyu/api/controller/certificate/SocialSecurityCardController.java @@ -16,14 +16,43 @@ import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; /** - * https://console.bce.baidu.com/support/?_=1740219852952×tamp=1740308886691#/api?product=AI&project=%E6%96%87%E5%AD%97%E8%AF%86%E5%88%AB&parent=%E5%8D%A1%E8%AF%81OCR&api=rest%2F2.0%2Focr%2Fv1%2Fsocial_security_card&method=post + * 社保卡识别控制器 *

+ * 基于百度 OCR API，对中国大陆社会保障卡进行结构化识别。 + * 支持识别全国各地社保卡，提取卡面关键信息用于身份验证和业务办理。 + *

*

- * 社保卡识别 + * 识别字段包括（8 个关键字段）： + *

+ *

*

+ * 注意事项： + *

+ *

*

- * 接口描述 - * 支持识别全国各地社保卡，支持识别社会保障卡号、姓名、性别、出生日期、银行卡号、有效期限等8个字段。 + * 适用场景： + *

+ *

+ *

+ * 接口路径：/socialSecurityCard/recognize + *

+ * + * @author heyu + * @since 1.0.0 */ @Slf4j @RestController @@ -35,6 +64,18 @@ public class SocialSecurityCardController extends BaseController { @Autowired private BSocialSecurityCardHandle bsocialSecurityCardHandle; + /** + * 社保卡识别接口 + *

+ * 接收社保卡图片（URL 或 Base64），调用百度 OCR API 进行结构化识别。 + * 返回社保卡上的姓名、卡号、性别等 8 个关键字段。 + *

+ * + * @param request 社保卡识别请求参数，包含以下字段（任选其一）： + * - imageBase64：图片 Base64 编码 + * - imageUrl：图片 URL + * @return 社保卡识别结果，包含姓名、性别、出生日期、卡号、社会保障卡号、银行卡号、签发日期、有效期限等字段 + */ @RequestMapping("/recognize") @CacheResult public R recognize(BSocialSecurityCardRequest request) { diff --git a/api-web/api-interface/src/main/java/com/heyu/api/controller/medical/HealthReportController.java b/api-web/api-interface/src/main/java/com/heyu/api/controller/medical/HealthReportController.java index 1abf68b..8da6d36 100644 --- a/api-web/api-interface/src/main/java/com/heyu/api/controller/medical/HealthReportController.java +++ b/api-web/api-interface/src/main/java/com/heyu/api/controller/medical/HealthReportController.java @@ -21,17 +21,46 @@ import java.util.List; -/*** +/** + * 医疗诊断报告单识别控制器 + *

+ * 基于百度 OCR API，对全国各地各医院的医疗诊断报告单进行结构化识别。 + * 支持提取报告中的关键医疗信息，便于医疗数据数字化和归档管理。 + *

+ *

+ * 识别字段包括（14 个关键字段）： + *

+ *

+ *

+ * 注意事项： + *

+ *

+ *

+ * 适用场景： + *

+ *

+ *

+ * 接口路径：/health/report + *

* - * https://console.bce.baidu.com/support/?_=1740575657628×tamp=1740581406549#/api?product=AI&project=%E6%96%87%E5%AD%97%E8%AF%86%E5%88%AB&parent=%E5%8C%BB%E7%96%97%E7%A5%A8%E6%8D%AEOCR&api=rest%2F2.0%2Focr%2Fv1%2Fhealth_report&method=post - *医疗诊断报告单识别 - * - * - * - 接口描述 - 支持识别全国各地各医院医疗诊断报告单，包括医院名称、报告名称、姓名、性别、年龄、科室、临床诊断、报告日期、检查部位、检查方法、检查所见、检查提示、建议、肉眼可见 14个字段。 - - + * @author heyu + * @since 1.0.0 */ @Slf4j @RestController @@ -44,6 +73,18 @@ public class HealthReportController extends BaseController { private BHealthReportHandle bHealthReportHandle; + /** + * 医疗诊断报告单识别接口 + *

+ * 接收医疗诊断报告单图片（URL 或 Base64），调用百度 OCR API 进行结构化识别。 + * 支持全国各地各医院的诊断报告单，提取 14 个关键字段信息。 + *

+ * + * @param req 医疗报告识别请求参数，包含以下字段（任选其一）： + * - imageBase64：图片 Base64 编码 + * - imageUrl：图片 URL + * @return 医疗报告识别结果列表，每个元素包含字段名称（wordName）和对应值（word） + */ @RequestMapping("/report") @CacheResult public R report(BHealthReportRequest req) { diff --git a/api-web/api-interface/src/main/java/com/heyu/api/controller/traffic/WaybillController.java b/api-web/api-interface/src/main/java/com/heyu/api/controller/traffic/WaybillController.java index bb93d30..266b6c9 100644 --- a/api-web/api-interface/src/main/java/com/heyu/api/controller/traffic/WaybillController.java +++ b/api-web/api-interface/src/main/java/com/heyu/api/controller/traffic/WaybillController.java @@ -21,14 +21,52 @@ import java.util.List; /** - * https://console.bce.baidu.com/support/?_=1740411162437×tamp=1740412723534#/api?product=AI&project=%E6%96%87%E5%AD%97%E8%AF%86%E5%88%AB&parent=%E4%BA%A4%E9%80%9A%E5%9C%BA%E6%99%AFOCR&api=rest%2F2.0%2Focr%2Fv1%2Fwaybill&method=post - * 快递面单识别 - * - * - * 接口描述 - * 支持市面上常见版式的快递面单识别，包括申通/圆通/中通/百世汇通/韵达/顺丰/京东/邮政/极兔/天天等面单版式，结构化识别运单号、收/寄件人姓名、收/寄件人电话、收/寄件人地址等字段。同时支持识别隐私面单。 - * + * 快递面单识别控制器 + *

+ * 基于百度 OCR API，对常见快递面单进行结构化识别。 + * 支持主流快递公司的面单版式，提取运单号、收寄件人信息、地址等关键字段。 + *

+ *

+ * 支持的快递公司： + *

+ *

+ *

+ * 识别字段包括： + *

+ *

+ *

+ * 注意事项： + *

+ *

+ *

+ * 适用场景： + *

+ *

+ *

+ * 接口路径：/waybill/recognize + *

* + * @author heyu + * @since 1.0.0 */ @Component @Slf4j