package org.wfc.omada.api.device;

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.device.model.ApBridgeConfig;
import org.wfc.omada.api.device.model.ApGeneralConfig;
import org.wfc.omada.api.device.model.ApIpSetting;
import org.wfc.omada.api.device.model.ApRadiosConfig;
import org.wfc.omada.api.device.model.ApSsidOverrideOpenApiV2Vo;
import org.wfc.omada.api.device.model.ApSsidOverrideOpenApiVo;
import org.wfc.omada.api.device.model.OperationResponseApAvailableChannelOpenApiVo;
import org.wfc.omada.api.device.model.OperationResponseApBridgeConfig;
import org.wfc.omada.api.device.model.OperationResponseApGeneralConfig;
import org.wfc.omada.api.device.model.OperationResponseApIpSetting;
import org.wfc.omada.api.device.model.OperationResponseApLanTraffic;
import org.wfc.omada.api.device.model.OperationResponseApOfdmaConfigOpenApiVo;
import org.wfc.omada.api.device.model.OperationResponseApOverviewInfo;
import org.wfc.omada.api.device.model.OperationResponseApPowerSavingConfigOpenApiVo;
import org.wfc.omada.api.device.model.OperationResponseApRadiosConfig;
import org.wfc.omada.api.device.model.OperationResponseApRadiosDetail;
import org.wfc.omada.api.device.model.OperationResponseApRfScanInfo;
import org.wfc.omada.api.device.model.OperationResponseApRfScanResult;
import org.wfc.omada.api.device.model.OperationResponseApSsidWlansOpenApiV2Vo;
import org.wfc.omada.api.device.model.OperationResponseApSsidWlansOpenApiVo;
import org.wfc.omada.api.device.model.OperationResponseApWiredDownlink;
import org.wfc.omada.api.device.model.OperationResponseApWiredUplink;
import org.wfc.omada.api.device.model.OperationResponseWithoutResult;
import org.wfc.omada.api.device.model.RfScanCommand;
import org.wfc.omada.api.device.model.UpdateApChannelConfigOpenApiVo;
import org.wfc.omada.api.device.model.UpdateApOfdmaConfigOpenApiVo;
import org.wfc.omada.api.device.model.UpdateApPowerSavingConfigOpenApiVo;

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

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

    /**
     * GET /openapi/v1/{omadacId}/sites/{siteId}/aps/{apMac}/bridge : Get P2P bridge config
     * Get P2P bridge config&lt;br/&gt;&lt;br/&gt;The interface requires one of the permissions: &lt;br/&gt;Site Device Manager View Only&lt;br/&gt;&lt;br/&gt;The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): &lt;br/&gt;-39303  -  AP does not exist.
     *
     * @param omadacId Omada ID (required)
     * @param siteId Site ID (required)
     * @param apMac AP MAC address, like AA-BB-CC-DD-EE-FF (required)
     * @return OK (status code 200)
     */
    @ApiOperation(value = "Get P2P bridge config", nickname = "getApBridgeInfo", notes = "Get P2P bridge config<br/><br/>The interface requires one of the permissions: <br/>Site Device Manager View Only<br/><br/>The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): <br/>-39303  -  AP does not exist.", response = OperationResponseApBridgeConfig.class, tags={ "Omada/Ap","Ap", })
    @ApiResponses(value = { 
        @ApiResponse(code = 200, message = "OK", response = OperationResponseApBridgeConfig.class) })
    @RequestMapping(value = "/openapi/v1/${omada.omadac-id}/sites/{siteId}/aps/{apMac}/bridge",
        produces = "*/*", 
        method = RequestMethod.GET)
    ResponseEntity<OperationResponseApBridgeConfig> getApBridgeInfo(@ApiParam(value = "Site ID",required=true) @PathVariable("siteId") String siteId,@ApiParam(value = "AP MAC address, like AA-BB-CC-DD-EE-FF",required=true) @PathVariable("apMac") String apMac);


    /**
     * GET /openapi/v1/{omadacId}/sites/{siteId}/aps/{apMac}/ofdma : Get ap OFDMA config
     * Get ap OFDMA config&lt;br/&gt;&lt;br/&gt;The interface requires one of the permissions: &lt;br/&gt;Site Device Manager View Only&lt;br/&gt;&lt;br/&gt;The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): &lt;br/&gt;-39303  -  AP does not exist.
     *
     * @param omadacId Omada ID (required)
     * @param siteId Site ID (required)
     * @param apMac AP MAC address, like AA-BB-CC-DD-EE-FF (required)
     * @return OK (status code 200)
     */
    @ApiOperation(value = "Get ap OFDMA config", nickname = "getApOfdmaConfig", notes = "Get ap OFDMA config<br/><br/>The interface requires one of the permissions: <br/>Site Device Manager View Only<br/><br/>The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): <br/>-39303  -  AP does not exist.", response = OperationResponseApOfdmaConfigOpenApiVo.class, tags={ "Omada/Ap","Ap", })
    @ApiResponses(value = { 
        @ApiResponse(code = 200, message = "OK", response = OperationResponseApOfdmaConfigOpenApiVo.class) })
    @RequestMapping(value = "/openapi/v1/${omada.omadac-id}/sites/{siteId}/aps/{apMac}/ofdma",
        produces = "*/*", 
        method = RequestMethod.GET)
    ResponseEntity<OperationResponseApOfdmaConfigOpenApiVo> getApOfdmaConfig(@ApiParam(value = "Site ID",required=true) @PathVariable("siteId") String siteId,@ApiParam(value = "AP MAC address, like AA-BB-CC-DD-EE-FF",required=true) @PathVariable("apMac") String apMac);


    /**
     * GET /openapi/v1/{omadacId}/sites/{siteId}/aps/{apMac}/available-channel : Get available channel list of ap
     * Get available channel list of ap&lt;br/&gt;&lt;br/&gt;The interface requires one of the permissions: &lt;br/&gt;Site Device Manager View Only&lt;br/&gt;&lt;br/&gt;The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): &lt;br/&gt;-39303  -  AP does not exist.&lt;br/&gt;-60004  -  The device is not activated. 
     *
     * @param omadacId Omada ID (required)
     * @param siteId Site ID (required)
     * @param apMac AP MAC address, like AA-BB-CC-DD-EE-FF (required)
     * @return OK (status code 200)
     */
    @ApiOperation(value = "Get available channel list of ap", nickname = "getAvailableChannelOfAp", notes = "Get available channel list of ap<br/><br/>The interface requires one of the permissions: <br/>Site Device Manager View Only<br/><br/>The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): <br/>-39303  -  AP does not exist.<br/>-60004  -  The device is not activated. ", response = OperationResponseApAvailableChannelOpenApiVo.class, tags={ "Omada/Ap","Ap", })
    @ApiResponses(value = { 
        @ApiResponse(code = 200, message = "OK", response = OperationResponseApAvailableChannelOpenApiVo.class) })
    @RequestMapping(value = "/openapi/v1/${omada.omadac-id}/sites/{siteId}/aps/{apMac}/available-channel",
        produces = "*/*", 
        method = RequestMethod.GET)
    ResponseEntity<OperationResponseApAvailableChannelOpenApiVo> getAvailableChannelOfAp(@ApiParam(value = "Site ID",required=true) @PathVariable("siteId") String siteId,@ApiParam(value = "AP MAC address, like AA-BB-CC-DD-EE-FF",required=true) @PathVariable("apMac") String apMac);


    /**
     * GET /openapi/v1/{omadacId}/sites/{siteId}/aps/{apMac}/wired-downlink : Get ap downlink(wired) device list
     * Get ap downlink(wired) device list&lt;br/&gt;&lt;br/&gt;The interface requires one of the permissions: &lt;br/&gt;Site Device Manager View Only&lt;br/&gt;&lt;br/&gt;The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): &lt;br/&gt;-1001  -  Invalid request parameters.&lt;br/&gt;-1005  -  Operation forbidden.&lt;br/&gt;-39303  -  AP does not exist.
     *
     * @param omadacId Omada ID (required)
     * @param siteId Site ID (required)
     * @param apMac AP MAC address, like AA-BB-CC-DD-EE-FF (required)
     * @return OK (status code 200)
     */
    @ApiOperation(value = "Get ap downlink(wired) device list", nickname = "getDownlinkWiredDevices", notes = "Get ap downlink(wired) device list<br/><br/>The interface requires one of the permissions: <br/>Site Device Manager View Only<br/><br/>The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): <br/>-1001  -  Invalid request parameters.<br/>-1005  -  Operation forbidden.<br/>-39303  -  AP does not exist.", response = OperationResponseApWiredDownlink.class, tags={ "Omada/Ap","Ap", })
    @ApiResponses(value = { 
        @ApiResponse(code = 200, message = "OK", response = OperationResponseApWiredDownlink.class) })
    @RequestMapping(value = "/openapi/v1/${omada.omadac-id}/sites/{siteId}/aps/{apMac}/wired-downlink",
        produces = "*/*", 
        method = RequestMethod.GET)
    ResponseEntity<OperationResponseApWiredDownlink> getDownlinkWiredDevices(@ApiParam(value = "Site ID",required=true) @PathVariable("siteId") String siteId,@ApiParam(value = "AP MAC address, like AA-BB-CC-DD-EE-FF",required=true) @PathVariable("apMac") String apMac);


    /**
     * GET /openapi/v1/{omadacId}/sites/{siteId}/aps/{apMac}/general-config : Get ap general config
     * Get ap general config&lt;br/&gt;&lt;br/&gt;The interface requires one of the permissions: &lt;br/&gt;Site Device Manager View Only&lt;br/&gt;&lt;br/&gt;The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): &lt;br/&gt;-39303  -  AP does not exist.
     *
     * @param omadacId Omada ID (required)
     * @param siteId Site ID (required)
     * @param apMac AP MAC address, like AA-BB-CC-DD-EE-FF (required)
     * @return OK (status code 200)
     */
    @ApiOperation(value = "Get ap general config", nickname = "getGeneralConfig2", notes = "Get ap general config<br/><br/>The interface requires one of the permissions: <br/>Site Device Manager View Only<br/><br/>The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): <br/>-39303  -  AP does not exist.", response = OperationResponseApGeneralConfig.class, tags={ "Omada/Ap","Ap", })
    @ApiResponses(value = { 
        @ApiResponse(code = 200, message = "OK", response = OperationResponseApGeneralConfig.class) })
    @RequestMapping(value = "/openapi/v1/${omada.omadac-id}/sites/{siteId}/aps/{apMac}/general-config",
        produces = "*/*", 
        method = RequestMethod.GET)
    ResponseEntity<OperationResponseApGeneralConfig> getGeneralConfig2(@ApiParam(value = "Site ID",required=true) @PathVariable("siteId") String siteId,@ApiParam(value = "AP MAC address, like AA-BB-CC-DD-EE-FF",required=true) @PathVariable("apMac") String apMac);


    /**
     * GET /openapi/v1/{omadacId}/sites/{siteId}/aps/{apMac}/ip-setting : Get ap ip setting
     * Get ap IP setting&lt;br/&gt;&lt;br/&gt;The interface requires one of the permissions: &lt;br/&gt;Site Device Manager View Only&lt;br/&gt;&lt;br/&gt;The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): &lt;br/&gt;-39303  -  AP does not exist.
     *
     * @param omadacId Omada ID (required)
     * @param siteId Site ID (required)
     * @param apMac AP MAC address, like AA-BB-CC-DD-EE-FF (required)
     * @return OK (status code 200)
     */
    @ApiOperation(value = "Get ap ip setting", nickname = "getIpSettingConfig", notes = "Get ap IP setting<br/><br/>The interface requires one of the permissions: <br/>Site Device Manager View Only<br/><br/>The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): <br/>-39303  -  AP does not exist.", response = OperationResponseApIpSetting.class, tags={ "Omada/Ap","Ap", })
    @ApiResponses(value = { 
        @ApiResponse(code = 200, message = "OK", response = OperationResponseApIpSetting.class) })
    @RequestMapping(value = "/openapi/v1/${omada.omadac-id}/sites/{siteId}/aps/{apMac}/ip-setting",
        produces = "*/*", 
        method = RequestMethod.GET)
    ResponseEntity<OperationResponseApIpSetting> getIpSettingConfig(@ApiParam(value = "Site ID",required=true) @PathVariable("siteId") String siteId,@ApiParam(value = "AP MAC address, like AA-BB-CC-DD-EE-FF",required=true) @PathVariable("apMac") String apMac);


    /**
     * GET /openapi/v1/{omadacId}/sites/{siteId}/aps/{apMac}/lan-traffic-info : Get ap lan traffic info
     * Get ap lan traffic info&lt;br/&gt;&lt;br/&gt;The interface requires one of the permissions: &lt;br/&gt;Site Device Manager View Only&lt;br/&gt;&lt;br/&gt;The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): &lt;br/&gt;-39303  -  AP does not exist.
     *
     * @param omadacId Omada ID (required)
     * @param siteId Site ID (required)
     * @param apMac AP MAC address, like AA-BB-CC-DD-EE-FF (required)
     * @return OK (status code 200)
     */
    @ApiOperation(value = "Get ap lan traffic info", nickname = "getLanDetail", notes = "Get ap lan traffic info<br/><br/>The interface requires one of the permissions: <br/>Site Device Manager View Only<br/><br/>The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): <br/>-39303  -  AP does not exist.", response = OperationResponseApLanTraffic.class, tags={ "Omada/Ap","Ap", })
    @ApiResponses(value = { 
        @ApiResponse(code = 200, message = "OK", response = OperationResponseApLanTraffic.class) })
    @RequestMapping(value = "/openapi/v1/${omada.omadac-id}/sites/{siteId}/aps/{apMac}/lan-traffic-info",
        produces = "*/*", 
        method = RequestMethod.GET)
    ResponseEntity<OperationResponseApLanTraffic> getLanDetail(@ApiParam(value = "Site ID",required=true) @PathVariable("siteId") String siteId,@ApiParam(value = "AP MAC address, like AA-BB-CC-DD-EE-FF",required=true) @PathVariable("apMac") String apMac);


    /**
     * GET /openapi/v1/{omadacId}/sites/{siteId}/aps/{apMac} : Get ap info
     * Get ap info&lt;br/&gt;&lt;br/&gt;The interface requires one of the permissions: &lt;br/&gt;Site Device Manager View Only&lt;br/&gt;&lt;br/&gt;The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): &lt;br/&gt;-39303  -  AP does not exist.
     *
     * @param omadacId Omada ID (required)
     * @param siteId Site ID (required)
     * @param apMac AP MAC address, like AA-BB-CC-DD-EE-FF (required)
     * @return OK (status code 200)
     */
    @ApiOperation(value = "Get ap info", nickname = "getOverviewDetail", notes = "Get ap info<br/><br/>The interface requires one of the permissions: <br/>Site Device Manager View Only<br/><br/>The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): <br/>-39303  -  AP does not exist.", response = OperationResponseApOverviewInfo.class, tags={ "Omada/Ap","Ap", })
    @ApiResponses(value = { 
        @ApiResponse(code = 200, message = "OK", response = OperationResponseApOverviewInfo.class) })
    @RequestMapping(value = "/openapi/v1/${omada.omadac-id}/sites/{siteId}/aps/{apMac}",
        produces = "*/*", 
        method = RequestMethod.GET)
    ResponseEntity<OperationResponseApOverviewInfo> getOverviewDetail(@ApiParam(value = "Site ID",required=true) @PathVariable("siteId") String siteId,@ApiParam(value = "AP MAC address, like AA-BB-CC-DD-EE-FF",required=true) @PathVariable("apMac") String apMac);


    /**
     * GET /openapi/v1/{omadacId}/sites/{siteId}/aps/{apMac}/power-saving : Get ap power saving config
     * Get ap power saving config&lt;br/&gt;&lt;br/&gt;The interface requires one of the permissions: &lt;br/&gt;Site Device Manager View Only&lt;br/&gt;&lt;br/&gt;The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): &lt;br/&gt;-39303  -  AP does not exist.
     *
     * @param omadacId Omada ID (required)
     * @param siteId Site ID (required)
     * @param apMac AP MAC address, like AA-BB-CC-DD-EE-FF (required)
     * @return OK (status code 200)
     */
    @ApiOperation(value = "Get ap power saving config", nickname = "getPowerSavingConfig", notes = "Get ap power saving config<br/><br/>The interface requires one of the permissions: <br/>Site Device Manager View Only<br/><br/>The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): <br/>-39303  -  AP does not exist.", response = OperationResponseApPowerSavingConfigOpenApiVo.class, tags={ "Omada/Ap","Ap", })
    @ApiResponses(value = { 
        @ApiResponse(code = 200, message = "OK", response = OperationResponseApPowerSavingConfigOpenApiVo.class) })
    @RequestMapping(value = "/openapi/v1/${omada.omadac-id}/sites/{siteId}/aps/{apMac}/power-saving",
        produces = "*/*", 
        method = RequestMethod.GET)
    ResponseEntity<OperationResponseApPowerSavingConfigOpenApiVo> getPowerSavingConfig(@ApiParam(value = "Site ID",required=true) @PathVariable("siteId") String siteId,@ApiParam(value = "AP MAC address, like AA-BB-CC-DD-EE-FF",required=true) @PathVariable("apMac") String apMac);


    /**
     * GET /openapi/v1/{omadacId}/sites/{siteId}/aps/{apMac}/rf-scan-result : Get rf scan result
     * Get rf scan result. This interface has been deprecated.&lt;br/&gt;&lt;br/&gt;The interface requires one of the permissions: &lt;br/&gt;Site Device Manager View Only&lt;br/&gt;&lt;br/&gt;The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): &lt;br/&gt;-34808  -  This AP is not connected.
     *
     * @param omadacId Omada ID (required)
     * @param siteId Site ID (required)
     * @param apMac AP MAC address, like AA-BB-CC-DD-EE-FF (required)
     * @return OK (status code 200)
     * @deprecated
     */
    @ApiOperation(value = "Get rf scan result", nickname = "getRFScanResult", notes = "Get rf scan result. This interface has been deprecated.<br/><br/>The interface requires one of the permissions: <br/>Site Device Manager View Only<br/><br/>The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): <br/>-34808  -  This AP is not connected.", response = OperationResponseApRfScanInfo.class, tags={ "Omada/Ap","Ap", })
    @ApiResponses(value = { 
        @ApiResponse(code = 200, message = "OK", response = OperationResponseApRfScanInfo.class) })
    @RequestMapping(value = "/openapi/v1/${omada.omadac-id}/sites/{siteId}/aps/{apMac}/rf-scan-result",
        produces = "*/*", 
        method = RequestMethod.GET)
    ResponseEntity<OperationResponseApRfScanInfo> getRFScanResult(@ApiParam(value = "Site ID",required=true) @PathVariable("siteId") String siteId,@ApiParam(value = "AP MAC address, like AA-BB-CC-DD-EE-FF",required=true) @PathVariable("apMac") String apMac);


    /**
     * GET /openapi/v2/{omadacId}/sites/{siteId}/aps/{apMac}/rf-scan-result : Get rf scan result
     * Get rf scan result&lt;br/&gt;&lt;br/&gt;The interface requires one of the permissions: &lt;br/&gt;Site Device Manager View Only&lt;br/&gt;&lt;br/&gt;The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): &lt;br/&gt;-34808  -  This AP is not connected.
     *
     * @param omadacId Omada ID (required)
     * @param siteId Site ID (required)
     * @param apMac AP MAC address, like AA-BB-CC-DD-EE-FF (required)
     * @return OK (status code 200)
     */
    @ApiOperation(value = "Get rf scan result", nickname = "getRFScanResultV2", notes = "Get rf scan result<br/><br/>The interface requires one of the permissions: <br/>Site Device Manager View Only<br/><br/>The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): <br/>-34808  -  This AP is not connected.", response = OperationResponseApRfScanResult.class, tags={ "Omada/Ap","Ap", })
    @ApiResponses(value = { 
        @ApiResponse(code = 200, message = "OK", response = OperationResponseApRfScanResult.class) })
    @RequestMapping(value = "/openapi/v2/{omadacId}/sites/{siteId}/aps/{apMac}/rf-scan-result",
        produces = "*/*", 
        method = RequestMethod.GET)
    ResponseEntity<OperationResponseApRfScanResult> getRFScanResultV2(@ApiParam(value = "Site ID",required=true) @PathVariable("siteId") String siteId,@ApiParam(value = "AP MAC address, like AA-BB-CC-DD-EE-FF",required=true) @PathVariable("apMac") String apMac);


    /**
     * GET /openapi/v1/{omadacId}/sites/{siteId}/aps/{apMac}/radio-config : Get ap radio config
     * Get ap radio config&lt;br/&gt;&lt;br/&gt;The interface requires one of the permissions: &lt;br/&gt;Site Device Manager View Only&lt;br/&gt;&lt;br/&gt;The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): &lt;br/&gt;-39303  -  AP does not exist.
     *
     * @param omadacId Omada ID (required)
     * @param siteId Site ID (required)
     * @param apMac AP MAC address, like AA-BB-CC-DD-EE-FF (required)
     * @return OK (status code 200)
     */
    @ApiOperation(value = "Get ap radio config", nickname = "getRadiosConfig", notes = "Get ap radio config<br/><br/>The interface requires one of the permissions: <br/>Site Device Manager View Only<br/><br/>The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): <br/>-39303  -  AP does not exist.", response = OperationResponseApRadiosConfig.class, tags={ "Omada/Ap","Ap", })
    @ApiResponses(value = { 
        @ApiResponse(code = 200, message = "OK", response = OperationResponseApRadiosConfig.class) })
    @RequestMapping(value = "/openapi/v1/${omada.omadac-id}/sites/{siteId}/aps/{apMac}/radio-config",
        produces = "*/*", 
        method = RequestMethod.GET)
    ResponseEntity<OperationResponseApRadiosConfig> getRadiosConfig(@ApiParam(value = "Site ID",required=true) @PathVariable("siteId") String siteId,@ApiParam(value = "AP MAC address, like AA-BB-CC-DD-EE-FF",required=true) @PathVariable("apMac") String apMac);


    /**
     * GET /openapi/v1/{omadacId}/sites/{siteId}/aps/{apMac}/radios : Get ap radio detail
     * Get ap radio detail&lt;br/&gt;&lt;br/&gt;The interface requires one of the permissions: &lt;br/&gt;Site Device Manager View Only&lt;br/&gt;&lt;br/&gt;The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): &lt;br/&gt;-39303  -  AP does not exist.
     *
     * @param omadacId Omada ID (required)
     * @param siteId Site ID (required)
     * @param apMac AP MAC address, like AA-BB-CC-DD-EE-FF (required)
     * @return OK (status code 200)
     */
    @ApiOperation(value = "Get ap radio detail", nickname = "getRadiosDetail", notes = "Get ap radio detail<br/><br/>The interface requires one of the permissions: <br/>Site Device Manager View Only<br/><br/>The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): <br/>-39303  -  AP does not exist.", response = OperationResponseApRadiosDetail.class, tags={ "Omada/Ap","Ap", })
    @ApiResponses(value = { 
        @ApiResponse(code = 200, message = "OK", response = OperationResponseApRadiosDetail.class) })
    @RequestMapping(value = "/openapi/v1/${omada.omadac-id}/sites/{siteId}/aps/{apMac}/radios",
        produces = "*/*", 
        method = RequestMethod.GET)
    ResponseEntity<OperationResponseApRadiosDetail> getRadiosDetail(@ApiParam(value = "Site ID",required=true) @PathVariable("siteId") String siteId,@ApiParam(value = "AP MAC address, like AA-BB-CC-DD-EE-FF",required=true) @PathVariable("apMac") String apMac);


    /**
     * GET /openapi/v1/{omadacId}/sites/{siteId}/aps/{apMac}/wired-uplink : Get ap uplink(wired) detail
     * Get ap uplink(wired) detail&lt;br/&gt;&lt;br/&gt;The interface requires one of the permissions: &lt;br/&gt;Site Device Manager View Only&lt;br/&gt;&lt;br/&gt;The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): &lt;br/&gt;-39303  -  AP does not exist.
     *
     * @param omadacId Omada ID (required)
     * @param siteId Site ID (required)
     * @param apMac AP MAC address, like AA-BB-CC-DD-EE-FF (required)
     * @return OK (status code 200)
     */
    @ApiOperation(value = "Get ap uplink(wired) detail", nickname = "getUplinkWiredDetail", notes = "Get ap uplink(wired) detail<br/><br/>The interface requires one of the permissions: <br/>Site Device Manager View Only<br/><br/>The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): <br/>-39303  -  AP does not exist.", response = OperationResponseApWiredUplink.class, tags={ "Omada/Ap","Ap", })
    @ApiResponses(value = { 
        @ApiResponse(code = 200, message = "OK", response = OperationResponseApWiredUplink.class) })
    @RequestMapping(value = "/openapi/v1/${omada.omadac-id}/sites/{siteId}/aps/{apMac}/wired-uplink",
        produces = "*/*", 
        method = RequestMethod.GET)
    ResponseEntity<OperationResponseApWiredUplink> getUplinkWiredDetail(@ApiParam(value = "Site ID",required=true) @PathVariable("siteId") String siteId,@ApiParam(value = "AP MAC address, like AA-BB-CC-DD-EE-FF",required=true) @PathVariable("apMac") String apMac);


    /**
     * GET /openapi/v1/{omadacId}/sites/{siteId}/aps/{apMac}/override : Get ap WLANs override config
     * Get ap WLANs override config. This interface has been deprecated.&lt;br/&gt;&lt;br/&gt;The interface requires one of the permissions: &lt;br/&gt;Site Device Manager View Only&lt;br/&gt;&lt;br/&gt;The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): &lt;br/&gt;-39303  -  AP does not exist.
     *
     * @param omadacId Omada ID (required)
     * @param siteId Site ID (required)
     * @param apMac AP MAC address, like AA-BB-CC-DD-EE-FF (required)
     * @return OK (status code 200)
     * @deprecated
     */
    @ApiOperation(value = "Get ap WLANs override config", nickname = "getWlansConfig", notes = "Get ap WLANs override config. This interface has been deprecated.<br/><br/>The interface requires one of the permissions: <br/>Site Device Manager View Only<br/><br/>The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): <br/>-39303  -  AP does not exist.", response = OperationResponseApSsidWlansOpenApiVo.class, tags={ "Omada/Ap","Ap", })
    @ApiResponses(value = { 
        @ApiResponse(code = 200, message = "OK", response = OperationResponseApSsidWlansOpenApiVo.class) })
    @RequestMapping(value = "/openapi/v1/${omada.omadac-id}/sites/{siteId}/aps/{apMac}/override",
        produces = "*/*", 
        method = RequestMethod.GET)
    ResponseEntity<OperationResponseApSsidWlansOpenApiVo> getWlansConfig(@ApiParam(value = "Site ID",required=true) @PathVariable("siteId") String siteId,@ApiParam(value = "AP MAC address, like AA-BB-CC-DD-EE-FF",required=true) @PathVariable("apMac") String apMac);


    /**
     * GET /openapi/v2/{omadacId}/sites/{siteId}/aps/{apMac}/override : Get ap WLANs override config
     * Get ap WLANs override config.&lt;br/&gt;&lt;br/&gt;The interface requires one of the permissions: &lt;br/&gt;Site Device Manager View Only&lt;br/&gt;&lt;br/&gt;The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): &lt;br/&gt;-39303  -  AP does not exist.
     *
     * @param omadacId Omada ID (required)
     * @param siteId Site ID (required)
     * @param apMac AP MAC address, like AA-BB-CC-DD-EE-FF (required)
     * @return OK (status code 200)
     */
    @ApiOperation(value = "Get ap WLANs override config", nickname = "getWlansConfigV2", notes = "Get ap WLANs override config.<br/><br/>The interface requires one of the permissions: <br/>Site Device Manager View Only<br/><br/>The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): <br/>-39303  -  AP does not exist.", response = OperationResponseApSsidWlansOpenApiV2Vo.class, tags={ "Omada/Ap","Ap", })
    @ApiResponses(value = { 
        @ApiResponse(code = 200, message = "OK", response = OperationResponseApSsidWlansOpenApiV2Vo.class) })
    @RequestMapping(value = "/openapi/v2/{omadacId}/sites/{siteId}/aps/{apMac}/override",
        produces = "*/*", 
        method = RequestMethod.GET)
    ResponseEntity<OperationResponseApSsidWlansOpenApiV2Vo> getWlansConfigV2(@ApiParam(value = "Site ID",required=true) @PathVariable("siteId") String siteId,@ApiParam(value = "AP MAC address, like AA-BB-CC-DD-EE-FF",required=true) @PathVariable("apMac") String apMac);


    /**
     * PATCH /openapi/v1/{omadacId}/sites/{siteId}/aps/{apMac}/bridge : Modify P2P bridge config
     * Modify P2P bridge config&lt;br/&gt;&lt;br/&gt;The interface requires one of the permissions: &lt;br/&gt;Site Device Manager Modify&lt;br/&gt;&lt;br/&gt;The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): &lt;br/&gt;-39303  -  AP does not exist.
     *
     * @param omadacId Omada ID (required)
     * @param siteId Site ID (required)
     * @param apMac AP MAC address, like AA-BB-CC-DD-EE-FF (required)
     * @param apBridgeConfig  (optional)
     * @return OK (status code 200)
     */
    @ApiOperation(value = "Modify P2P bridge config", nickname = "modifyApBridgeInfo", notes = "Modify P2P bridge config<br/><br/>The interface requires one of the permissions: <br/>Site Device Manager Modify<br/><br/>The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): <br/>-39303  -  AP does not exist.", response = OperationResponseWithoutResult.class, tags={ "Omada/Ap","Ap", })
    @ApiResponses(value = { 
        @ApiResponse(code = 200, message = "OK", response = OperationResponseWithoutResult.class) })
    @RequestMapping(value = "/openapi/v1/${omada.omadac-id}/sites/{siteId}/aps/{apMac}/bridge",
        produces = "*/*", 
        consumes = "application/json",
        method = RequestMethod.PATCH)
    ResponseEntity<OperationResponseWithoutResult> modifyApBridgeInfo(@ApiParam(value = "Site ID",required=true) @PathVariable("siteId") String siteId,@ApiParam(value = "AP MAC address, like AA-BB-CC-DD-EE-FF",required=true) @PathVariable("apMac") String apMac,@ApiParam(value = ""  )  @Valid @RequestBody(required = false) ApBridgeConfig apBridgeConfig);


    /**
     * PUT /openapi/v1/{omadacId}/sites/{siteId}/aps/{apMac}/channel-config : Modify ap channel config
     * Modify ap channel config&lt;br/&gt;&lt;br/&gt;The interface requires one of the permissions: &lt;br/&gt;Site Device Manager Modify&lt;br/&gt;&lt;br/&gt;The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): &lt;br/&gt;-39303  -  AP does not exist.
     *
     * @param omadacId Omada ID (required)
     * @param siteId Site ID (required)
     * @param apMac AP MAC address, like AA-BB-CC-DD-EE-FF (required)
     * @param updateApChannelConfigOpenApiVo  (optional)
     * @return OK (status code 200)
     */
    @ApiOperation(value = "Modify ap channel config", nickname = "modifyApChannelConfig", notes = "Modify ap channel config<br/><br/>The interface requires one of the permissions: <br/>Site Device Manager Modify<br/><br/>The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): <br/>-39303  -  AP does not exist.", response = OperationResponseWithoutResult.class, tags={ "Omada/Ap","Ap", })
    @ApiResponses(value = { 
        @ApiResponse(code = 200, message = "OK", response = OperationResponseWithoutResult.class) })
    @RequestMapping(value = "/openapi/v1/${omada.omadac-id}/sites/{siteId}/aps/{apMac}/channel-config",
        produces = "*/*", 
        consumes = "application/json",
        method = RequestMethod.PUT)
    ResponseEntity<OperationResponseWithoutResult> modifyApChannelConfig(@ApiParam(value = "Site ID",required=true) @PathVariable("siteId") String siteId,@ApiParam(value = "AP MAC address, like AA-BB-CC-DD-EE-FF",required=true) @PathVariable("apMac") String apMac,@ApiParam(value = ""  )  @Valid @RequestBody(required = false) UpdateApChannelConfigOpenApiVo updateApChannelConfigOpenApiVo);


    /**
     * PATCH /openapi/v1/{omadacId}/sites/{siteId}/aps/{apMac}/ofdma : Modify ap OFDMA config
     * Modify ap OFDMA config; If the device does not support this feature, it cannot be modified successfully.&lt;br/&gt;&lt;br/&gt;The interface requires one of the permissions: &lt;br/&gt;Site Device Manager Modify&lt;br/&gt;&lt;br/&gt;The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): &lt;br/&gt;-39303  -  AP does not exist.
     *
     * @param omadacId Omada ID (required)
     * @param siteId Site ID (required)
     * @param apMac AP MAC address, like AA-BB-CC-DD-EE-FF (required)
     * @param updateApOfdmaConfigOpenApiVo  (optional)
     * @return OK (status code 200)
     */
    @ApiOperation(value = "Modify ap OFDMA config", nickname = "modifyApOfdmaConfig", notes = "Modify ap OFDMA config; If the device does not support this feature, it cannot be modified successfully.<br/><br/>The interface requires one of the permissions: <br/>Site Device Manager Modify<br/><br/>The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): <br/>-39303  -  AP does not exist.", response = OperationResponseWithoutResult.class, tags={ "Omada/Ap","Ap", })
    @ApiResponses(value = { 
        @ApiResponse(code = 200, message = "OK", response = OperationResponseWithoutResult.class) })
    @RequestMapping(value = "/openapi/v1/${omada.omadac-id}/sites/{siteId}/aps/{apMac}/ofdma",
        produces = "*/*", 
        consumes = "application/json",
        method = RequestMethod.PATCH)
    ResponseEntity<OperationResponseWithoutResult> modifyApOfdmaConfig(@ApiParam(value = "Site ID",required=true) @PathVariable("siteId") String siteId,@ApiParam(value = "AP MAC address, like AA-BB-CC-DD-EE-FF",required=true) @PathVariable("apMac") String apMac,@ApiParam(value = ""  )  @Valid @RequestBody(required = false) UpdateApOfdmaConfigOpenApiVo updateApOfdmaConfigOpenApiVo);


    /**
     * PATCH /openapi/v1/{omadacId}/sites/{siteId}/aps/{apMac}/general-config : Modify ap general config
     * Modify ap general config&lt;br/&gt;&lt;br/&gt;The interface requires one of the permissions: &lt;br/&gt;Site Device Manager Modify&lt;br/&gt;&lt;br/&gt;The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): &lt;br/&gt;-39303  -  AP does not exist.
     *
     * @param omadacId Omada ID (required)
     * @param siteId Site ID (required)
     * @param apMac AP MAC address, like AA-BB-CC-DD-EE-FF (required)
     * @param apGeneralConfig  (optional)
     * @return OK (status code 200)
     */
    @ApiOperation(value = "Modify ap general config", nickname = "modifyGeneralConfig2", notes = "Modify ap general config<br/><br/>The interface requires one of the permissions: <br/>Site Device Manager Modify<br/><br/>The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): <br/>-39303  -  AP does not exist.", response = OperationResponseWithoutResult.class, tags={ "Omada/Ap","Ap", })
    @ApiResponses(value = { 
        @ApiResponse(code = 200, message = "OK", response = OperationResponseWithoutResult.class) })
    @RequestMapping(value = "/openapi/v1/${omada.omadac-id}/sites/{siteId}/aps/{apMac}/general-config",
        produces = "*/*", 
        consumes = "application/json",
        method = RequestMethod.PATCH)
    ResponseEntity<OperationResponseWithoutResult> modifyGeneralConfig2(@ApiParam(value = "Site ID",required=true) @PathVariable("siteId") String siteId,@ApiParam(value = "AP MAC address, like AA-BB-CC-DD-EE-FF",required=true) @PathVariable("apMac") String apMac,@ApiParam(value = ""  )  @Valid @RequestBody(required = false) ApGeneralConfig apGeneralConfig);


    /**
     * PATCH /openapi/v1/{omadacId}/sites/{siteId}/aps/{apMac}/ip-setting : Modify ap ip setting
     * Modify ap IP setting&lt;br/&gt;&lt;br/&gt;The interface requires one of the permissions: &lt;br/&gt;Site Device Manager Modify&lt;br/&gt;&lt;br/&gt;The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): &lt;br/&gt;-39303  -  AP does not exist.
     *
     * @param omadacId Omada ID (required)
     * @param siteId Site ID (required)
     * @param apMac AP MAC address, like AA-BB-CC-DD-EE-FF (required)
     * @param apIpSetting  (optional)
     * @return OK (status code 200)
     */
    @ApiOperation(value = "Modify ap ip setting", nickname = "modifyIpSettingConfig", notes = "Modify ap IP setting<br/><br/>The interface requires one of the permissions: <br/>Site Device Manager Modify<br/><br/>The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): <br/>-39303  -  AP does not exist.", response = OperationResponseWithoutResult.class, tags={ "Omada/Ap","Ap", })
    @ApiResponses(value = { 
        @ApiResponse(code = 200, message = "OK", response = OperationResponseWithoutResult.class) })
    @RequestMapping(value = "/openapi/v1/${omada.omadac-id}/sites/{siteId}/aps/{apMac}/ip-setting",
        produces = "*/*", 
        consumes = "application/json",
        method = RequestMethod.PATCH)
    ResponseEntity<OperationResponseWithoutResult> modifyIpSettingConfig(@ApiParam(value = "Site ID",required=true) @PathVariable("siteId") String siteId,@ApiParam(value = "AP MAC address, like AA-BB-CC-DD-EE-FF",required=true) @PathVariable("apMac") String apMac,@ApiParam(value = ""  )  @Valid @RequestBody(required = false) ApIpSetting apIpSetting);


    /**
     * PUT /openapi/v1/{omadacId}/sites/{siteId}/aps/{apMac}/power-saving : Modify ap power saving config
     * Modify ap power saving config; If the device does not support this feature, it cannot be modified successfully.&lt;br/&gt;&lt;br/&gt;The interface requires one of the permissions: &lt;br/&gt;Site Device Manager Modify&lt;br/&gt;&lt;br/&gt;The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): &lt;br/&gt;-39303  -  AP does not exist.&lt;br/&gt;-44205  -  The device does not support this feature.
     *
     * @param omadacId Omada ID (required)
     * @param siteId Site ID (required)
     * @param apMac AP MAC address, like AA-BB-CC-DD-EE-FF (required)
     * @param updateApPowerSavingConfigOpenApiVo  (optional)
     * @return OK (status code 200)
     */
    @ApiOperation(value = "Modify ap power saving config", nickname = "modifyPowerSavingConfig", notes = "Modify ap power saving config; If the device does not support this feature, it cannot be modified successfully.<br/><br/>The interface requires one of the permissions: <br/>Site Device Manager Modify<br/><br/>The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): <br/>-39303  -  AP does not exist.<br/>-44205  -  The device does not support this feature.", response = OperationResponseWithoutResult.class, tags={ "Omada/Ap","Ap", })
    @ApiResponses(value = { 
        @ApiResponse(code = 200, message = "OK", response = OperationResponseWithoutResult.class) })
    @RequestMapping(value = "/openapi/v1/${omada.omadac-id}/sites/{siteId}/aps/{apMac}/power-saving",
        produces = "*/*", 
        consumes = "application/json",
        method = RequestMethod.PUT)
    ResponseEntity<OperationResponseWithoutResult> modifyPowerSavingConfig(@ApiParam(value = "Site ID",required=true) @PathVariable("siteId") String siteId,@ApiParam(value = "AP MAC address, like AA-BB-CC-DD-EE-FF",required=true) @PathVariable("apMac") String apMac,@ApiParam(value = ""  )  @Valid @RequestBody(required = false) UpdateApPowerSavingConfigOpenApiVo updateApPowerSavingConfigOpenApiVo);


    /**
     * PATCH /openapi/v1/{omadacId}/sites/{siteId}/aps/{apMac}/radio-config : Modify ap radio config
     * Modify ap radio config&lt;br/&gt;&lt;br/&gt;The interface requires one of the permissions: &lt;br/&gt;Site Device Manager Modify&lt;br/&gt;&lt;br/&gt;The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): &lt;br/&gt;-39303  -  AP does not exist.
     *
     * @param omadacId Omada ID (required)
     * @param siteId Site ID (required)
     * @param apMac AP MAC address, like AA-BB-CC-DD-EE-FF (required)
     * @param apRadiosConfig  (optional)
     * @return OK (status code 200)
     */
    @ApiOperation(value = "Modify ap radio config", nickname = "modifyRadiosConfig", notes = "Modify ap radio config<br/><br/>The interface requires one of the permissions: <br/>Site Device Manager Modify<br/><br/>The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): <br/>-39303  -  AP does not exist.", response = OperationResponseWithoutResult.class, tags={ "Omada/Ap","Ap", })
    @ApiResponses(value = { 
        @ApiResponse(code = 200, message = "OK", response = OperationResponseWithoutResult.class) })
    @RequestMapping(value = "/openapi/v1/${omada.omadac-id}/sites/{siteId}/aps/{apMac}/radio-config",
        produces = "*/*", 
        consumes = "application/json",
        method = RequestMethod.PATCH)
    ResponseEntity<OperationResponseWithoutResult> modifyRadiosConfig(@ApiParam(value = "Site ID",required=true) @PathVariable("siteId") String siteId,@ApiParam(value = "AP MAC address, like AA-BB-CC-DD-EE-FF",required=true) @PathVariable("apMac") String apMac,@ApiParam(value = ""  )  @Valid @RequestBody(required = false) ApRadiosConfig apRadiosConfig);


    /**
     * PATCH /openapi/v1/{omadacId}/sites/{siteId}/aps/{apMac}/override : Modify ap WLANs override config
     * Modify ap WLANs override config. This interface has been deprecated.&lt;br/&gt;&lt;br/&gt;The interface requires one of the permissions: &lt;br/&gt;Site Device Manager Modify&lt;br/&gt;&lt;br/&gt;The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): &lt;br/&gt;-39303  -  AP does not exist.
     *
     * @param omadacId Omada ID (required)
     * @param siteId Site ID (required)
     * @param apMac AP MAC address, like AA-BB-CC-DD-EE-FF (required)
     * @param apSsidOverrideOpenApiVo  (optional)
     * @return OK (status code 200)
     * @deprecated
     */
    @ApiOperation(value = "Modify ap WLANs override config", nickname = "modifyWlansConfig", notes = "Modify ap WLANs override config. This interface has been deprecated.<br/><br/>The interface requires one of the permissions: <br/>Site Device Manager Modify<br/><br/>The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): <br/>-39303  -  AP does not exist.", response = OperationResponseWithoutResult.class, tags={ "Omada/Ap","Ap", })
    @ApiResponses(value = { 
        @ApiResponse(code = 200, message = "OK", response = OperationResponseWithoutResult.class) })
    @RequestMapping(value = "/openapi/v1/${omada.omadac-id}/sites/{siteId}/aps/{apMac}/override",
        produces = "*/*", 
        consumes = "application/json",
        method = RequestMethod.PATCH)
    ResponseEntity<OperationResponseWithoutResult> modifyWlansConfig(@ApiParam(value = "Site ID",required=true) @PathVariable("siteId") String siteId,@ApiParam(value = "AP MAC address, like AA-BB-CC-DD-EE-FF",required=true) @PathVariable("apMac") String apMac,@ApiParam(value = ""  )  @Valid @RequestBody(required = false) ApSsidOverrideOpenApiVo apSsidOverrideOpenApiVo);


    /**
     * PATCH /openapi/v2/{omadacId}/sites/{siteId}/aps/{apMac}/override : Modify ap WLANs override config
     * Modify ap WLANs override config.&lt;br/&gt;&lt;br/&gt;The interface requires one of the permissions: &lt;br/&gt;Site Device Manager Modify&lt;br/&gt;&lt;br/&gt;The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): &lt;br/&gt;-39303  -  AP does not exist.
     *
     * @param omadacId Omada ID (required)
     * @param siteId Site ID (required)
     * @param apMac AP MAC address, like AA-BB-CC-DD-EE-FF (required)
     * @param apSsidOverrideOpenApiV2Vo  (optional)
     * @return OK (status code 200)
     */
    @ApiOperation(value = "Modify ap WLANs override config", nickname = "modifyWlansConfigV2", notes = "Modify ap WLANs override config.<br/><br/>The interface requires one of the permissions: <br/>Site Device Manager Modify<br/><br/>The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): <br/>-39303  -  AP does not exist.", response = OperationResponseWithoutResult.class, tags={ "Omada/Ap","Ap", })
    @ApiResponses(value = { 
        @ApiResponse(code = 200, message = "OK", response = OperationResponseWithoutResult.class) })
    @RequestMapping(value = "/openapi/v2/{omadacId}/sites/{siteId}/aps/{apMac}/override",
        produces = "*/*", 
        consumes = "application/json",
        method = RequestMethod.PATCH)
    ResponseEntity<OperationResponseWithoutResult> modifyWlansConfigV2(@ApiParam(value = "Site ID",required=true) @PathVariable("siteId") String siteId,@ApiParam(value = "AP MAC address, like AA-BB-CC-DD-EE-FF",required=true) @PathVariable("apMac") String apMac,@ApiParam(value = ""  )  @Valid @RequestBody(required = false) ApSsidOverrideOpenApiV2Vo apSsidOverrideOpenApiV2Vo);


    /**
     * POST /openapi/v1/{omadacId}/sites/{siteId}/aps/{apMac}/start-rf-scan : Start rf scan
     * Wi-Fi connection will lost for several minutes during the scanning. Please select a spare time of network to start scanning. This interface has been deprecated.&lt;br/&gt;&lt;br/&gt;The interface requires one of the permissions: &lt;br/&gt;Site Device Manager Modify&lt;br/&gt;&lt;br/&gt;The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): &lt;br/&gt;-34800  -  No SSIDs are configured on the corresponding radio band.&lt;br/&gt;-34802  -  RF scan failed. Please turn on the radio.&lt;br/&gt;-34803  -  Optimizing WLAN... Please wait.&lt;br/&gt;-34808  -  This AP is not connected.&lt;br/&gt;-34809  -  This AP does not support RF Scanning.&lt;br/&gt;-34810  -  Mesh APs do not support RF Scanning.
     *
     * @param omadacId Omada ID (required)
     * @param siteId Site ID (required)
     * @param apMac AP MAC address, like AA-BB-CC-DD-EE-FF (required)
     * @return OK (status code 200)
     * @deprecated
     */
    @ApiOperation(value = "Start rf scan", nickname = "triggerRadioFrequencyScan", notes = "Wi-Fi connection will lost for several minutes during the scanning. Please select a spare time of network to start scanning. This interface has been deprecated.<br/><br/>The interface requires one of the permissions: <br/>Site Device Manager Modify<br/><br/>The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): <br/>-34800  -  No SSIDs are configured on the corresponding radio band.<br/>-34802  -  RF scan failed. Please turn on the radio.<br/>-34803  -  Optimizing WLAN... Please wait.<br/>-34808  -  This AP is not connected.<br/>-34809  -  This AP does not support RF Scanning.<br/>-34810  -  Mesh APs do not support RF Scanning.", response = OperationResponseWithoutResult.class, tags={ "Omada/Ap","Ap", })
    @ApiResponses(value = { 
        @ApiResponse(code = 200, message = "OK", response = OperationResponseWithoutResult.class) })
    @RequestMapping(value = "/openapi/v1/${omada.omadac-id}/sites/{siteId}/aps/{apMac}/start-rf-scan",
        produces = "*/*", 
        method = RequestMethod.POST)
    ResponseEntity<OperationResponseWithoutResult> triggerRadioFrequencyScan(@ApiParam(value = "Site ID",required=true) @PathVariable("siteId") String siteId,@ApiParam(value = "AP MAC address, like AA-BB-CC-DD-EE-FF",required=true) @PathVariable("apMac") String apMac);


    /**
     * POST /openapi/v2/{omadacId}/sites/{siteId}/aps/{apMac}/start-rf-scan : Start rf scan
     * Wi-Fi connection will lost for several minutes during the scanning. Please select a spare time of network to start scanning.&lt;br/&gt;&lt;br/&gt;The interface requires one of the permissions: &lt;br/&gt;Site Device Manager Modify&lt;br/&gt;&lt;br/&gt;The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): &lt;br/&gt;-34800  -  No SSIDs are configured on the corresponding radio band.&lt;br/&gt;-34802  -  RF scan failed. Please turn on the radio.&lt;br/&gt;-34803  -  Optimizing WLAN... Please wait.&lt;br/&gt;-34808  -  This AP is not connected.&lt;br/&gt;-34809  -  This AP does not support RF Scanning.&lt;br/&gt;-34810  -  Mesh APs do not support RF Scanning.&lt;br/&gt;-34824  -  Rogue AP scanning... Please wait.
     *
     * @param omadacId Omada ID (required)
     * @param siteId Site ID (required)
     * @param apMac AP MAC address, like AA-BB-CC-DD-EE-FF (required)
     * @param rfScanCommand  (optional)
     * @return OK (status code 200)
     */
    @ApiOperation(value = "Start rf scan", nickname = "triggerRadioFrequencyScanV2", notes = "Wi-Fi connection will lost for several minutes during the scanning. Please select a spare time of network to start scanning.<br/><br/>The interface requires one of the permissions: <br/>Site Device Manager Modify<br/><br/>The possible error code for the interface in the returned body is one of the following error codes (non generic error codes): <br/>-34800  -  No SSIDs are configured on the corresponding radio band.<br/>-34802  -  RF scan failed. Please turn on the radio.<br/>-34803  -  Optimizing WLAN... Please wait.<br/>-34808  -  This AP is not connected.<br/>-34809  -  This AP does not support RF Scanning.<br/>-34810  -  Mesh APs do not support RF Scanning.<br/>-34824  -  Rogue AP scanning... Please wait.", response = OperationResponseWithoutResult.class, tags={ "Omada/Ap","Ap", })
    @ApiResponses(value = { 
        @ApiResponse(code = 200, message = "OK", response = OperationResponseWithoutResult.class) })
    @RequestMapping(value = "/openapi/v2/{omadacId}/sites/{siteId}/aps/{apMac}/start-rf-scan",
        produces = "*/*", 
        consumes = "application/json",
        method = RequestMethod.POST)
    ResponseEntity<OperationResponseWithoutResult> triggerRadioFrequencyScanV2(@ApiParam(value = "Site ID",required=true) @PathVariable("siteId") String siteId,@ApiParam(value = "AP MAC address, like AA-BB-CC-DD-EE-FF",required=true) @PathVariable("apMac") String apMac,@ApiParam(value = ""  )  @Valid @RequestBody(required = false) RfScanCommand rfScanCommand);

}
