package com.tashow.cloud.systemapi.api.oauth2;

import com.tashow.cloud.common.pojo.CommonResult;
import com.tashow.cloud.systemapi.api.oauth2.dto.OAuth2AccessTokenCheckRespDTO;
import com.tashow.cloud.systemapi.api.oauth2.dto.OAuth2AccessTokenCreateReqDTO;
import com.tashow.cloud.systemapi.api.oauth2.dto.OAuth2AccessTokenRespDTO;
import com.tashow.cloud.systemapi.enums.ApiConstants;
import jakarta.validation.Valid;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.*;

@FeignClient(name = ApiConstants.NAME) // TODO 芋艿：fallbackFactory =
/** RPC 服务 - OAuth2.0 令牌 */
public interface OAuth2TokenApi {

  String PREFIX = ApiConstants.PREFIX + "/oauth2/token";

  /** 校验 Token 的 URL 地址，主要是提供给 Gateway 使用 */
  @SuppressWarnings("HttpUrlsUsage")
  String URL_CHECK = "http://" + ApiConstants.NAME + PREFIX + "/check";

  @PostMapping(PREFIX + "/create")
  /** 创建访问令牌 */
  CommonResult<OAuth2AccessTokenRespDTO> createAccessToken(
      @Valid @RequestBody OAuth2AccessTokenCreateReqDTO reqDTO);

  @GetMapping(PREFIX + "/check")
  /** 校验访问令牌 */
  CommonResult<OAuth2AccessTokenCheckRespDTO> checkAccessToken(
      @RequestParam("accessToken") String accessToken);

  @DeleteMapping(PREFIX + "/remove")
  /** 移除访问令牌 */
  CommonResult<OAuth2AccessTokenRespDTO> removeAccessToken(
      @RequestParam("accessToken") String accessToken);

  @PutMapping(PREFIX + "/refresh")
  /** 刷新访问令牌 */
  CommonResult<OAuth2AccessTokenRespDTO> refreshAccessToken(
      @RequestParam("refreshToken") String refreshToken, @RequestParam("clientId") String clientId);
}
