98 lines
3.1 KiB
Java

package com.ebike.feign.clients;
import com.cdzy.common.model.EbikeUserFaultreportDto;
import com.cdzy.common.model.EbikeUserFaultreportQueryDto;
import com.cdzy.common.model.JsonResult;
import com.ebike.feign.model.res.ResFeignOrderPaymentDto;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestParam;
import java.util.List;
/**
* 用车(订单) 外部调用。
*
* @author dingchao
* @date 2025/4/17
* @modified by:
*/
@FeignClient(name = "ebike-orders")
public interface OrdersFeignClient {
/**
* 批量更新用户上报故障信息。
*
* @param ebikeUserFaultreports 用户上报故障信息列表
* @return {@code true} 批量更新成功,{@code false} 批量更新失败
*/
@PostMapping("ebikeUserFaultreport/updateBatch")
JsonResult<?> updateUserFaultreports(@RequestBody List<EbikeUserFaultreportDto> ebikeUserFaultreports);
/**
* 查询某台车所有用户上报故障信息。
*
* @param queryParam 查询参数
* @return 列表, 含附件列表
*/
@PostMapping("ebikeUserFaultreport/list")
JsonResult<?> getUserReportList(@RequestBody EbikeUserFaultreportQueryDto queryParam);
/**
* 订单支付完成
* @param paymentParam 支付信息
* @return @ {@code 200} 成功,{@code 500} 失败
*/
@PostMapping("userOrders/payment")
JsonResult<?> payment(@RequestBody ResFeignOrderPaymentDto paymentParam);
/**
* 根据ID获取订单支付详情
* @param orderId 支付id
* @return 订单支付详情
*/
@GetMapping("userOrders/paymentDetailsInfo")
JsonResult<?> getPaymentDetails(@RequestParam("orderId")Long orderId);
/**
* 订单发起退款
* @param orderId 订单ID
* @return @ {@code 200} 成功,{@code 500} 失败
*/
@GetMapping("userOrders/refund")
JsonResult<?> refund(@RequestParam("orderId")Long orderId);
/**
* 订单发起退款申请
* @param orderId 订单ID
* @return @ {@code 200} 成功,{@code 500} 失败
*/
@GetMapping("userOrders/refundApply")
JsonResult<?> refundApply(@RequestParam("orderId")Long orderId);
/**
* 订单退款完成
* @param orderId 订单ID
* @return @ {@code 200} 成功,{@code 500} 失败
*/
@GetMapping("userOrders/doneRefund")
JsonResult<?> doneRefund(@RequestParam("orderId")Long orderId);
/**
* 订单退款驳回
* @param orderId 订单ID
* @return @ {@code 200} 成功,{@code 500} 失败
*/
@GetMapping("userOrders/rejectRefund")
JsonResult<?> rejectRefund(@RequestParam("orderId")Long orderId);
/**
* 订单退款失败
* @param orderId 订单ID
* @return @ {@code 200} 成功,{@code 500} 失败
*/
@GetMapping("userOrders/failRefund")
JsonResult<?> failRefund(@RequestParam("orderId")Long orderId);
}