我刚刚发现我们可以在几个字段上使用@apiparam：

@PostMapping(value = "personnePhysique", produces = { MediaType.APPLICATION_OCTET_STREAM_VALUE })
public ResponseEntity<InputStreamResource> getRapportSolvabilitePPUsingPOST(
        @ApiParam(value = "rapportPP", required = true) @Valid @RequestBody RapportPP rapportPP,
        @ApiParam(value = "apiHeader", required = false, hidden = true) @RequestHeader Map<String, String> apiHeader)
        throws BusinessException {
    RapportPPDTO dto = mapper.convertValue(rapportPP, RapportPPDTO.class);
    String apiId = null;
    String apiPwd = null;
    /* Iterate over apiHeaders map */
    for (Map.Entry<String, String> entry : apiHeader.entrySet()) {
        if(entry.getKey().equals(ApiConstants.CB_API_USER_ID) && entry.getValue().equals(ApiConstants.CB_API_USER_PWD))
        {
            apiId = entry.getKey();
            apiPwd = entry.getValue();
        }
        System.out.println("Item : " + entry.getKey() + " Count : " + entry.getValue());
        System.out.println("apiId : " + apiId);
        System.out.println("apiPwd : " + apiPwd);

    }
    /* Iterate over apiHeaders map */
    try {
        ByteArrayInputStream array = this.rapportSolvabiliteService.getRapportSolvabilitePhysique(dto, apiId, apiPwd);
        return toSubscribeContractModel(array, "rapportSolvabilite.pdf");
    } catch (BusinessException e) {
        throw new BusinessException(500, message.getString(ApiConstants.TECHNICAL_ERROR_MESSAGE_KEY), e);
    }
}

因此，如您所见，您可以为每一个指定值，如本例中所示：
apiheader是隐藏的，不是必需的
没有隐藏和要求
谢谢