第三方系统检测人查询接口

    /**
     * 构造标准签名原文
     * 形如：
     * <pre>pageNumber=1&pageSize=20&userNo=U10001&mobile=1880000000000&name=张三</pre>
     *
     * @return 签名原文
     */
    public static String getSignCanonicalString(UserQueryRequest request) {

        if (request == null) {
            return "";
        }

        // 固定顺序（TreeMap 按 key 排序）
        Map<String, String> sortedParams = new TreeMap<>();

        // 注意：null → ""
        sortedParams.put("pageNumber", valueOf(request.getPageNumber()));
        sortedParams.put("pageSize", valueOf(request.getPageSize()));
        sortedParams.put("userNo", valueOf(request.getUserNo()));
        sortedParams.put("mobile", valueOf(request.getMobile()));
        sortedParams.put("name", valueOf(request.getName()));

        StringBuilder canonical = new StringBuilder();
        for (Map.Entry<String, String> entry : sortedParams.entrySet()) {
            canonical.append(entry.getKey())
                    .append("=")
                    .append(entry.getValue())
                    .append("&");
        }

        // 去掉最后一个 &
        canonical.deleteCharAt(canonical.length() - 1);

        return canonical.toString();
    }

    private static String valueOf(Object value) {
        return value == null ? "" : String.valueOf(value);
    }

    /**
     * 签名
     *
     * @param appKey    key（开通接口后平台侧提供）
     * @param appSecret 秘钥（开通接口后平台侧提供）
     * @param timestamp 时间戳
     * @param nonce     随机数
     * @param body      查询参数
     * @return 签名
     */
    public static String sign(String appKey,
                              String appSecret,
                              String timestamp,
                              String nonce,
                              String body) {

        String content = appKey + timestamp + nonce + body;
        return new HmacUtils(HmacAlgorithms.HMAC_SHA_256, appSecret)
                .hmacHex(content);
    }

/**
 * 第三方系统检测人查询接口  demo
 *
 * @author yzkj
 * @date 2026/1/19 14:42
 */
@RestController
@AllArgsConstructor
@RequestMapping("/yzapi")
public class demo {
    
    /**
     * 宽容时间
     */
    private static final long ALLOWED_TIME_WINDOW = 5 * 60 * 1000L;


    private static final String YZ_APP_KEY = "appKey";
    private static final String YZ_APP_SECRET = "appSecret";

    /**
     * 生产建议使用redis
     * 添加 TTL
     */
    private final Set<String> nonceKeyCache = ConcurrentHashMap.newKeySet();


    @PostMapping(value = "/checkperson/query")
    public ResultObj query(@RequestHeader("YZ-Timestamp") String timestamp,
                               @RequestHeader("YZ-Nonce") String nonce,
                               @RequestHeader("YZ-Signature") String signature,
                               @RequestBody UserQueryRequest requestRawBody) {

        // 1~4 步：统一鉴权
        // 1. 校验 timestamp
        long requestTime = Long.parseLong(timestamp);
        long now = System.currentTimeMillis();
        if (Math.abs(now - requestTime) > ALLOWED_TIME_WINDOW) {
            return ResultObj.error(40102, "时间戳过期");
        }

        // 2. 校验 nonce
        String nonceKey = YZ_APP_KEY + ":" + nonce;
        if (nonceKeyCache.contains(nonceKey)) {
            return ResultObj.error(40103, "重复请求");
        }
        // 生产系统建议添加 TTL 避免缓存过多随机码
        nonceKeyCache.add(nonceKey);

        // 3. 重新计算签名
        // 3.1 构造标准签名原文 Canonical String
        String signCanonicalString = getSignCanonicalString(requestRawBody);
        String expectedSignature = sign(YZ_APP_KEY, YZ_APP_SECRET, timestamp, nonce, signCanonicalString);

        // 4. 对比签名
        if (!expectedSignature.equals(signature)) {
            return ResultObj.error(40101, "签名错误");
        }

        // 5. 执行条件查询，返回分页数据
        // 自行处理业务数据查询
        List<ThirdPartyUserDTO> list = new ArrayList<>();
        // 模拟数据查询结果
        ThirdPartyUserDTO u1 = new ThirdPartyUserDTO("U10001", "张三", "13800000001", "M", "1990-01-15");
        ThirdPartyUserDTO u2 = new ThirdPartyUserDTO("U10002", "张四", "13800000002", "F", "1990-01-15");
        ThirdPartyUserDTO u3 = new ThirdPartyUserDTO("U10003", "王五", "13800000003", "M", "1990-01-15");

        list.add(u1);
        list.add(u2);
        list.add(u3);

        RecordResult recordResult = new RecordResult(1, 3, 3L, list);


        return ResultObj.data(recordResult);
    }

    /**
     * 构造查询条件标准签名原文
     * 形如：
     * <pre>pageNumber=1&pageSize=20&userNo=U10001&mobile=1880000000000&name=张三</pre>
     *
     * @return 签名原文
     */
    public static String getSignCanonicalString(UserQueryRequest request) {

        if (request == null) {
            return "";
        }

        // 固定顺序（TreeMap 按 key 排序）
        Map<String, String> sortedParams = new TreeMap<>();

        // 注意：null → ""
        sortedParams.put("pageNumber", valueOf(request.getPageNumber()));
        sortedParams.put("pageSize", valueOf(request.getPageSize()));
        sortedParams.put("userNo", valueOf(request.getUserNo()));
        sortedParams.put("mobile", valueOf(request.getMobile()));
        sortedParams.put("name", valueOf(request.getName()));

        StringBuilder canonical = new StringBuilder();
        for (Map.Entry<String, String> entry : sortedParams.entrySet()) {
            canonical.append(entry.getKey())
                    .append("=")
                    .append(entry.getValue())
                    .append("&");
        }

        // 去掉最后一个 &
        canonical.deleteCharAt(canonical.length() - 1);

        return canonical.toString();
    }

    private static String valueOf(Object value) {
        return value == null ? "" : String.valueOf(value);
    }

    /**
     * 签名
     *
     * @param appKey    key（开通接口后平台侧提供）
     * @param appSecret 秘钥（开通接口后平台侧提供）
     * @param timestamp 时间戳
     * @param nonce     随机数
     * @param body      查询参数
     * @return 签名
     */
    public static String sign(String appKey,
                              String appSecret,
                              String timestamp,
                              String nonce,
                              String body) {

        String content = appKey + timestamp + nonce + body;
        return new HmacUtils(HmacAlgorithms.HMAC_SHA_256, appSecret).hmacHex(content);
    }


    /**
     * 查询参数
     */
    @Data
    public static class UserQueryRequest {
        /**
         * 当前页码，从 1 开始
         */
        private Integer pageNumber;
        /**
         * 每页条数（默认传递20）
         */
        private Integer pageSize;
        /**
         * 用户编号（唯一标识）
         */
        private String userNo;
        /**
         * 手机号
         */
        private String mobile;
        /**
         * 用户姓名
         */
        private String name;

    }

    /**
     * 检测人对象
     */
    @Data
    @AllArgsConstructor
    public static class ThirdPartyUserDTO implements Serializable {

        /**
         * 用户唯一标识
         */
        private String userNo;

        /**
         * 姓名
         */
        private String name;

        /**
         * 手机号
         */
        private String mobile;

        /**
         * 性别：M-男性 / F-女性
         */
        private String gender;

        /**
         * 生日，格式 yyyy-MM-dd
         */
        private String birthday;
        
        /**
         * 过敏药物
         */
        private String allergyMedication;

        /**
         * 现病史
         */
        private String medicalHistory;

        /**
         * 身高(cm)
         */
        private BigDecimal height;

        /**
         * 体重(kg)
         */
        private BigDecimal weight;

        /**
         * 身份证号
         */
        private String idNumber;

        /**
         * 住址
         */
        private String address;


        public ThirdPartyUserDTO(String userNo, String name, String mobile, String gender, String birthday) {
            this.userNo = userNo;
            this.name = name;
            this.mobile = mobile;
            this.gender = gender;
            this.birthday = birthday;
        }


    }


    /**
     * 分页查询返回
     */
    @Data
    @AllArgsConstructor
    public static class RecordResult implements Serializable {

        /**
         * 当前页码
         */
        private Integer current;

        /**
         * 每页大小
         */
        private Integer size;

        /**
         * 总记录数
         */
        private Long total;

        /**
         * 用户数据列表
         */
        private List<ThirdPartyUserDTO> records;

    }


    @Data
    public static class ResultObj implements Serializable {

        private static final long serialVersionUID = 1L;

        /**
         * 成功标志
         */
        private boolean success;

        /**
         * 消息
         */
        private String message;

        /**
         * 返回代码
         */
        private Integer code;

        /**
         * 时间戳
         */
        private long timestamp = System.currentTimeMillis();

        /**
         * 结果对象
         */
        private RecordResult result;


        /**
         * 返回失败
         *
         * @param code 状态码
         * @param msg  返回消息
         * @return 消息
         */
        public static ResultObj error(Integer code, String msg) {
            ResultObj resultObj = new ResultObj();
            resultObj.setSuccess(false);
            resultObj.setMessage(msg);
            resultObj.setCode(code);
            resultObj.setResult(null);

            return resultObj;
        }

        /**
         * 返回成功
         *
         * @return 消息
         */
        public static ResultObj data(RecordResult result) {
            ResultObj resultObj = new ResultObj();
            resultObj.setSuccess(true);
            resultObj.setMessage("");
            resultObj.setCode(200);
            resultObj.setResult(result);

            return resultObj;
        }


    }

}