add

internal/domains/api/services/api_request_service.go

@@ -224,6 +224,7 @@ func registerAllProcessors(combService *comb.CombService) {
 		"QCXG8A3D": qcxg.ProcessQCXG8A3DRequest,
 		"QCXG6B4E": qcxg.ProcessQCXG6B4ERequest,
 		"QCXG4896": qcxg.ProcessQCXG4896Request,
+		"QCXG5F3A": qcxg.ProcessQCXG5F3ARequest, // 极光个人车辆查询
 
 		// DWBG系列处理器 - 多维报告
 		"DWBG6A2C": dwbg.ProcessDWBG6A2CRequest,

internal/domains/api/services/form_config_service.go

@@ -204,6 +204,7 @@ func (s *FormConfigServiceImpl) getDTOStruct(ctx context.Context, apiCode string
 		"IVYZZQT3": &dto.IVYZZQT3Req{}, //人脸比对V3
 		"IVYZBPQ2": &dto.IVYZBPQ2Req{}, //人脸比对V2
 		"IVYZSFEL": &dto.IVYZSFELReq{}, //全国自然人人像三要素核验_V1
+		"QCXG5F3A": &dto.QCXG5F3AReq{}, //极光个人车辆查询
 	}
 
 	// 优先返回已配置的DTO

internal/domains/api/services/processors/ivyz/ivyz9h2m_processor.go

@@ -23,12 +23,14 @@ func ProcessIVYZ9H2MRequest(ctx context.Context, params []byte, deps *processors
 
 	// 构建请求参数
 	reqData := map[string]interface{}{
-		"idNo": paramsDto.IDNo,
+		"idNo": paramsDto.IDCard,
 		"name": paramsDto.Name,
 	}
 
-	// 调用极光API，apiCode为 marriage-single-v2
-	respBytes, err := deps.JiguangService.CallAPI(ctx, "marriage-single-v2", reqData)
+	// 调用极光API
+	// apiCode: marriage-single-v2 (用于请求头)
+	// apiPath: marriage/single-v2 (用于URL路径)
+	respBytes, err := deps.JiguangService.CallAPI(ctx, "marriage-single-v2", "marriage/single-v2", reqData)
 	if err != nil {
 		// 根据错误类型返回相应的错误
 		if errors.Is(err, jiguang.ErrNotFound) {

internal/domains/api/services/processors/qcxg/qcxg5f3a_processor.go

@@ -0,0 +1,47 @@
+package qcxg
+
+import (
+	"context"
+	"encoding/json"
+	"errors"
+
+	"tyapi-server/internal/domains/api/dto"
+	"tyapi-server/internal/domains/api/services/processors"
+	"tyapi-server/internal/infrastructure/external/jiguang"
+)
+
+// ProcessQCXG5F3ARequest QCXG5F3A API处理方法 - 极光个人车辆查询
+func ProcessQCXG5F3ARequest(ctx context.Context, params []byte, deps *processors.ProcessorDependencies) ([]byte, error) {
+	var paramsDto dto.QCXG5F3AReq
+	if err := json.Unmarshal(params, &paramsDto); err != nil {
+		return nil, errors.Join(processors.ErrSystem, err)
+	}
+
+	if err := deps.Validator.ValidateStruct(paramsDto); err != nil {
+		return nil, errors.Join(processors.ErrInvalidParam, err)
+	}
+
+	// 构建请求参数
+	reqData := map[string]interface{}{
+		"id_card": paramsDto.IDCard,
+	}
+
+	// 调用极光API
+	// apiCode: vehicle-person-vehicles (用于请求头)
+	// apiPath: vehicle/person-vehicles (用于URL路径)
+	respBytes, err := deps.JiguangService.CallAPI(ctx, "vehicle-person-vehicles", "vehicle/person-vehicles", reqData)
+	if err != nil {
+		// 根据错误类型返回相应的错误
+		if errors.Is(err, jiguang.ErrNotFound) {
+			return nil, errors.Join(processors.ErrNotFound, err)
+		} else if errors.Is(err, jiguang.ErrDatasource) {
+			return nil, errors.Join(processors.ErrDatasource, err)
+		} else {
+			return nil, errors.Join(processors.ErrSystem, err)
+		}
+	}
+
+	// 极光服务已经返回了 data 字段的 JSON，直接返回即可
+	return respBytes, nil
+}
+