{"type":"api","title":"Returns active rogue aps","meta":{"id":"/apps/pubhub/media/cisco-cmx-v11-0-0/c5aed5a4a2c41c993164672f27e8c5acda4dd890/984c8ace-1ab9-3c1d-89a9-c0650f6a37ef","info":{"title":"Location API","version":"1.0.0","description":"This is Location API. Use the Location based REST APIs to retrieve client location data programmatically from the Cisco CMX."},"openapi":"3.0.0","servers":[{"url":"/fakecmxserver"}]},"spec":{"operationId":"activeRogueAPs","summary":"Returns active rogue aps","description":"This API supports searching by a variety of parameters. If no parameters are given then all active rogueaps are returned.\u003c/br\u003e\u003c/br\u003eThe API Username is set using the \u003cstrong\u003ecmxos apiserver user\u003c/strong\u003e command. This will change the username and password just for the Active V3 Rogue AP API.\u003c/br\u003e\u003c/br\u003eHere are some examples to illustrate the queries. \u003c/br\u003e\u003c/br\u003e\u003cstrong\u003eSearch by IPv4/IPv6:\u003c/strong\u003e api/location/v3/rogueaps?ipAddress=x.x.x.x\u003c/strong\u003e\u003cbr/\u003e\u003cstrong\u003eSearch by Mac Address:\u003c/strong\u003e api/location/v3/rogueaps?macAddress=x:x:x:x\u003c/strong\u003e\u003cbr/\u003e\u003cstrong\u003eSearch by Map Hierarchy:\u003c/strong\u003e api/location/v3/rogueaps?mapHierarchy=someFloorName\u003c/strong\u003e\u003cbr/\u003eMap Hierarchy string can be partial string matches but any string used must be an exact match.\u003cbr/\u003e\u003cstrong\u003eSearch by Floor Id:\u003c/strong\u003e api/location/v3/rogueaps?floorId=x:x:x:x\u003c/strong\u003e\u003cbr/\u003e","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"notificationType":"locationupdate","subscriptionName":"CMX_Api_Server_Notification_1","eventId":7791838,"locationMapHierarchy":"System Campus\u003eWLC-244-43\u003eWLC-244-43-F1","locationCoordinate":{"x":57.154472,"y":38.875927,"z":0,"unit":"FEET"},"geoCoordinate":{"latitude":-999,"longitude":-999,"unit":"DEGREES"},"confidenceFactor":48,"apMacAddress":"NOT APPLICABLE","associated":false,"username":"NOT APPLICABLE","ipAddress":["NOT APPLICABLE"],"ssid":"NOT APPLICABLE","band":"NOT APPLICABLE","floorId":"727001524986708012","entity":"ROGUE_APS","deviceId":"2c:57:41:89:99:cf","lastSeen":"2021-05-19T03:10:05.160-0700","rawLocation":{"rawX":-999,"rawY":-999,"unit":"FEET"},"tagVendorData":null,"bleTagInfo":null,"locComputeType":"RSSI","manufacturer":"Cisco Systems, Inc","maxDetectedRssi":{"apMacAddress":"b0:8b:cf:54:5c:80","band":"IEEE_802_11_A","slot":1,"rssi":-64,"antennaIndex":0,"lastHeardInSeconds":106},"hierarchyDetails":{"campusParents":null,"campus":{"id":"1617954166291","name":"System Campus"},"building":{"id":"727001524986708011","name":"WLC-244-43"},"floor":{"id":"727001524986708012","name":"WLC-244-43-F1"},"zones":null},"rssiEntries":[{"apMacAddress":"b0:8b:cf:54:5c:80","band":"IEEE_802_11_A","slot":1,"antennaIndex":0,"rssi":-64,"lastHeardSecs":106},"…………."],"timestamp":1621419005160,"sourceNotification":"127.0.0.1","sourceNotificationKey":"127.0.0.1,3","notificationTime":"1621419005175","macAddress":"2c:57:41:89:99:cf"}}}},"401":{"description":"Error Message","content":{"application/json":{"schema":{"type":"object"},"example":{"error":"CMX: System error"}}}}},"parameters":[{"name":"ipAddress","in":"query","required":false,"description":"Rogue AP IP address","schema":{"type":"string","default":""}},{"name":"macAddress","in":"query","required":false,"description":"Rogue AP MAC address","schema":{"type":"string","default":""}},{"name":"mapHierarchy","in":"query","required":false,"description":"Rogue APs with MAP hierarchy string","schema":{"type":"string","default":""}},{"name":"floorId","in":"query","required":false,"description":"Rogue APs on floor ID","schema":{"type":"string","default":""}}],"__originalOperationId":"activeRogueAPs","method":"get","path":"/location/v3/rogueaps"}}