package com.talentcard.server.business.portal;
|
|
import java.util.List;
|
import java.util.Map;
|
|
import com.talentcard.server.common.ApiResponse;
|
import com.talentcard.server.request.TicketPackageClaimRequest;
|
import com.talentcard.server.service.TicketPackagePortalService;
|
import io.swagger.v3.oas.annotations.Operation;
|
import io.swagger.v3.oas.annotations.Parameter;
|
import io.swagger.v3.oas.annotations.tags.Tag;
|
import jakarta.validation.Valid;
|
import org.springframework.web.bind.annotation.GetMapping;
|
import org.springframework.web.bind.annotation.PathVariable;
|
import org.springframework.web.bind.annotation.PostMapping;
|
import org.springframework.web.bind.annotation.RequestBody;
|
import org.springframework.web.bind.annotation.RequestHeader;
|
import org.springframework.web.bind.annotation.RequestMapping;
|
import org.springframework.web.bind.annotation.RequestParam;
|
import org.springframework.web.bind.annotation.RestController;
|
|
@Tag(name = "小程序-票包领取", description = "小程序按可兑换额度领取票包兑换码")
|
@RestController
|
@RequestMapping("/api/app/ticket-packages")
|
public class TicketPackagePortalController {
|
private final TicketPackagePortalService service;
|
|
public TicketPackagePortalController(TicketPackagePortalService service) {
|
this.service = service;
|
}
|
|
@Operation(summary = "查询可领取票包", description = "根据人才卡等级和可兑换额度返回可领取票包、库存和剩余额度")
|
@GetMapping
|
public ApiResponse<List<Map<String, Object>>> packages(
|
@Parameter(description = "持卡人ID") @RequestParam(required = false) Long talentId,
|
@Parameter(description = "人才卡ID；不传时取有效卡") @RequestParam(required = false) Long cardId,
|
@Parameter(description = "指定兑换商家ID") @RequestParam(required = false) Long merchantId
|
) {
|
return ApiResponse.success(service.packages(talentId, cardId, merchantId));
|
}
|
|
@Operation(summary = "领取票包兑换码", description = "校验可兑换额度并锁定/发放一个可用兑换码")
|
@PostMapping("/{packageId}/claims")
|
public ApiResponse<Map<String, Object>> claim(
|
@Parameter(description = "票包ID") @PathVariable Long packageId,
|
@Valid @RequestBody TicketPackageClaimRequest request,
|
@RequestHeader(value = "X-Idempotency-Key", required = false) String idempotencyKey
|
) {
|
return ApiResponse.success(service.claim(packageId, request, idempotencyKey));
|
}
|
}
|
