package org.wfc.omada.api.globalsetting;

import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import io.swagger.annotations.ApiParam;
import io.swagger.annotations.ApiResponse;
import io.swagger.annotations.ApiResponses;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.http.ResponseEntity;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.wfc.omada.config.FeignConfig;
import org.wfc.omada.api.globalsetting.model.DeviceAccessManagementSetting;
import org.wfc.omada.api.globalsetting.model.OperationResponseDeviceAccessManagementSetting;
import org.wfc.omada.api.globalsetting.model.OperationResponseWithoutResult;

import javax.validation.Valid;
@javax.annotation.Generated(value = "org.openapitools.codegen.languages.SpringCodegen", date = "2024-12-04T11:48:47.026+08:00[Asia/Shanghai]")

@Validated
@Api(value = "OmadaDeviceManagementSetting", description = "the OmadaDeviceManagementSetting API")
@FeignClient(name="OmadaDeviceManagementSettingApi", url = "${omada.omada-url}", configuration = FeignConfig.class)
public interface OmadaDeviceManagementSettingApi {

    /**
     * GET /openapi/v1/{omadacId}/device-mgmt : Get device access management setting
     * Get device access management setting.&lt;br/&gt;&lt;br/&gt;The interface requires one of the permissions: &lt;br/&gt;Global Other Setting View Only
     *
     * @param omadacId Omada ID (required)
     * @return OK (status code 200)
     */
    @ApiOperation(value = "Get device access management setting", nickname = "getDeviceAccessMgmtSetting", notes = "Get device access management setting.<br/><br/>The interface requires one of the permissions: <br/>Global Other Setting View Only", response = OperationResponseDeviceAccessManagementSetting.class, tags={ "Omada/Device Management Setting","Device Management Setting", })
    @ApiResponses(value = { 
        @ApiResponse(code = 200, message = "OK", response = OperationResponseDeviceAccessManagementSetting.class) })
    @RequestMapping(value = "/openapi/v1/${omada.omadac-id}/device-mgmt",
        produces = "*/*", 
        method = RequestMethod.GET)
    ResponseEntity<OperationResponseDeviceAccessManagementSetting> getDeviceAccessMgmtSetting(@ApiParam(value = "Omada ID",required=true) @PathVariable("omadacId") String omadacId);


    /**
     * PATCH /openapi/v1/{omadacId}/device-mgmt : Modify device access management setting
     * Modify device access management setting.&lt;br/&gt;&lt;br/&gt;The interface requires one of the permissions: &lt;br/&gt;Global Other Setting Modify
     *
     * @param omadacId Omada ID (required)
     * @param deviceAccessManagementSetting  (optional)
     * @return OK (status code 200)
     */
    @ApiOperation(value = "Modify device access management setting", nickname = "modifyDeviceAccessMgmtSetting", notes = "Modify device access management setting.<br/><br/>The interface requires one of the permissions: <br/>Global Other Setting Modify", response = OperationResponseWithoutResult.class, tags={ "Omada/Device Management Setting","Device Management Setting", })
    @ApiResponses(value = { 
        @ApiResponse(code = 200, message = "OK", response = OperationResponseWithoutResult.class) })
    @RequestMapping(value = "/openapi/v1/${omada.omadac-id}/device-mgmt",
        produces = "*/*", 
        consumes = "application/json",
        method = RequestMethod.PATCH)
    ResponseEntity<OperationResponseWithoutResult> modifyDeviceAccessMgmtSetting(@ApiParam(value = ""  )  @Valid @RequestBody(required = false) DeviceAccessManagementSetting deviceAccessManagementSetting);

}
