updating the swagger content

revert-70aa11f8
Shavindri Dissanayake 7 years ago
parent af430cba61
commit ead0e202d6

@ -67,8 +67,7 @@ import javax.ws.rs.core.Response;
} }
) )
@Path("/activities") @Path("/activities")
@Api(value = "Activity Info Provider", description = "Activity related information manipulation. For example" + @Api(value = "Getting Activity Details", description = "Get the details of the operations/activities executed by the server on the registered devices during a defined time period.")
" operation details and responses from devices.")
@Scopes( @Scopes(
scopes = { scopes = {
@Scope( @Scope(
@ -88,9 +87,8 @@ public interface ActivityInfoProviderService {
@ApiOperation( @ApiOperation(
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
httpMethod = "GET", httpMethod = "GET",
value = "Getting Details of an Activity", value = "Getting the Details of a Specific Activity",
notes = "Retrieve the details of a specific activity/operation, such as the meta information of " + notes = "Retrieve the details of a specific activity/operation, such as the meta information of an operation, and the responses from the devices.",
"an operation, including the responses from the devices.",
tags = "Activity Info Provider", tags = "Activity Info Provider",
extensions = { extensions = {
@Extension(properties = { @Extension(properties = {
@ -142,7 +140,7 @@ public interface ActivityInfoProviderService {
Response getActivity( Response getActivity(
@ApiParam( @ApiParam(
name = "id", name = "id",
value = "Activity id of the operation/activity.", value = "Activity ID of the operation/activity.",
required = true, required = true,
defaultValue = "ACTIVITY_1") defaultValue = "ACTIVITY_1")
@PathParam("id") @PathParam("id")
@ -161,9 +159,9 @@ public interface ActivityInfoProviderService {
@ApiOperation( @ApiOperation(
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
httpMethod = "GET", httpMethod = "GET",
value = "Getting Details of activities for given set of activity/operation Ids", value = "Getting Activity Details of Specified Activity/Operation IDs",
notes = "Retrieve the details of specific activity/operation Ids, such as the meta information of " + notes = "Retrieve the details of activities or operations, such as the meta information of an operation, and the responses from the devices."+
"an operation, including the responses from the devices.", "Define the activity or operation IDs as comma separated values.",
tags = "Activity Info Provider", tags = "Activity Info Provider",
extensions = { extensions = {
@Extension(properties = { @Extension(properties = {
@ -213,7 +211,7 @@ public interface ActivityInfoProviderService {
Response getActivities( Response getActivities(
@ApiParam( @ApiParam(
name = "ids", name = "ids",
value = "Comma separated activity/operation ids", value = "Comma separated activity/operation IDs",
required = true, required = true,
defaultValue = "ACTIVITY_0") defaultValue = "ACTIVITY_0")
@QueryParam("ids") ActivityIdList activityIdList); @QueryParam("ids") ActivityIdList activityIdList);
@ -224,9 +222,8 @@ public interface ActivityInfoProviderService {
@ApiOperation( @ApiOperation(
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
httpMethod = "GET", httpMethod = "GET",
value = "Getting Details of an Activity for a specific device", value = "Getting a Specific Activity Details of a Device",
notes = "Retrieve the details of a specific activity/operation, such as the meta information of " + notes = "Retrieve the details of a specific activity/operation, that was sent to a specific device.",
"an operation, including the responses from a given device",
tags = "Activity Info Provider", tags = "Activity Info Provider",
extensions = { extensions = {
@Extension(properties = { @Extension(properties = {
@ -286,7 +283,7 @@ public interface ActivityInfoProviderService {
String id, String id,
@ApiParam( @ApiParam(
name = "devicetype", name = "devicetype",
value = "The device type name, such as ios, android, windows or fire-alarm.", value = "The device type name, such as ios, android, windows, or fire-alarm.",
required = true) required = true)
@PathParam("devicetype") @PathParam("devicetype")
@Size(max = 45) @Size(max = 45)

@ -112,8 +112,8 @@ public interface DeviceAgentService {
@ApiOperation( @ApiOperation(
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
httpMethod = "POST", httpMethod = "POST",
value = "Create a device instance", value = "Creating a Device Instance",
notes = "Create a device Instance", notes = "Create a device instance using this API. Since this is not a physical device you are not able to try out device operations.",
tags = "Device Management", tags = "Device Management",
extensions = { extensions = {
@Extension(properties = { @Extension(properties = {
@ -157,7 +157,7 @@ public interface DeviceAgentService {
"Server error occurred while retrieving the device details.", "Server error occurred while retrieving the device details.",
response = ErrorResponse.class) response = ErrorResponse.class)
}) })
Response enrollDevice(@ApiParam(name = "device", value = "Device object with data.", required = true) Response enrollDevice(@ApiParam(name = "device", value = "Define the payload to create a device instance. You can double click on the Example Value and define your values in it to create the instance.", required = true)
@Valid Device device); @Valid Device device);
@DELETE @DELETE
@ -186,7 +186,7 @@ public interface DeviceAgentService {
"Server error occurred while dis-enrolling the device.") "Server error occurred while dis-enrolling the device.")
}) })
Response disEnrollDevice( Response disEnrollDevice(
@ApiParam(name = "type", value = "The unique device identifier.") @PathParam("type") String type, @ApiParam(name = "type", value = "Define the device type, such as android, ios, or windows.") @PathParam("type") String type,
@ApiParam(name = "id", value = "The unique device identifier.") @PathParam("id") String id); @ApiParam(name = "id", value = "The unique device identifier.") @PathParam("id") String id);
@PUT @PUT
@ -194,8 +194,8 @@ public interface DeviceAgentService {
@ApiOperation( @ApiOperation(
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
httpMethod = "PUT", httpMethod = "PUT",
value = "modify device", value = "Updating the Device Details",
notes = "modify device", notes = "You are able to update the details of a device using the API.",
tags = "Device Agent Management", tags = "Device Agent Management",
extensions = { extensions = {
@Extension(properties = { @Extension(properties = {
@ -239,15 +239,15 @@ public interface DeviceAgentService {
"Server error occurred while retrieving the device details.", "Server error occurred while retrieving the device details.",
response = ErrorResponse.class) response = ErrorResponse.class)
}) })
Response updateDevice(@ApiParam(name = "type", value = "The device type, such as ios, android or windows....etc", required = true) Response updateDevice(@ApiParam(name = "type", value = "The device type, such as ios, android, or windows.", required = true)
@PathParam("type") String type, @PathParam("type") String type,
@ApiParam(name = "id", value = "The device id.", required = true) @ApiParam(name = "id", value = "The device ID.", required = true)
@PathParam("id") String deviceId, @PathParam("id") String deviceId,
@ApiParam(name = "device", value = "Device object with data.", required = true) @ApiParam(name = "device", value = "Update the device details in the device object.", required = true)
@Valid Device updateDevice); @Valid Device updateDevice);
@POST @POST
@Path("/events/publish/{type}/{deviceId}") @Path("events/publish{type}/{deviceId}")
@ApiOperation( @ApiOperation(
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
consumes = MediaType.APPLICATION_JSON, consumes = MediaType.APPLICATION_JSON,
@ -303,11 +303,11 @@ public interface DeviceAgentService {
Map<String, Object> payloadData, Map<String, Object> payloadData,
@ApiParam( @ApiParam(
name = "type", name = "type",
value = "name of the device type") value = "The name of the device type, such as android, ios, or windows.")
@PathParam("type") String type, @PathParam("type") String type,
@ApiParam( @ApiParam(
name = "deviceId", name = "deviceId",
value = "deviceId of the device") value = "The device ID.")
@PathParam("deviceId") String deviceId); @PathParam("deviceId") String deviceId);
@POST @POST
@ -380,8 +380,8 @@ public interface DeviceAgentService {
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
consumes = MediaType.APPLICATION_JSON, consumes = MediaType.APPLICATION_JSON,
httpMethod = "GET", httpMethod = "GET",
value = "Get pending operation of the given device", value = "Getting All the Pending Operations of a Device",
notes = "Returns the Operations.", notes = "You can get all the list of pending operations of a device.",
tags = "Device Agent Management", tags = "Device Agent Management",
extensions = { extensions = {
@Extension(properties = { @Extension(properties = {
@ -426,9 +426,9 @@ public interface DeviceAgentService {
"Server error occurred while retrieving information requested device.", "Server error occurred while retrieving information requested device.",
response = ErrorResponse.class) response = ErrorResponse.class)
}) })
Response getPendingOperations(@ApiParam(name = "type", value = "The device type, such as ios, android or windows.", required = true) Response getPendingOperations(@ApiParam(name = "type", value = "The device type, such as ios, android, or windows.", required = true)
@PathParam("type") String type, @PathParam("type") String type,
@ApiParam(name = "id", value = "The device id.", required = true) @ApiParam(name = "id", value = "The device ID.", required = true)
@PathParam("id") String deviceId); @PathParam("id") String deviceId);
@GET @GET
@ -437,8 +437,8 @@ public interface DeviceAgentService {
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
consumes = MediaType.APPLICATION_JSON, consumes = MediaType.APPLICATION_JSON,
httpMethod = "GET", httpMethod = "GET",
value = "Get pending operation of the given device", value = "Getting the Next Pending Operations of a Device",
notes = "Returns the Operation.", notes = "There can be many operations that are pending on the device end. Get the next pending operation of a specific device using this API.",
tags = "Device Agent Management", tags = "Device Agent Management",
extensions = { extensions = {
@Extension(properties = { @Extension(properties = {
@ -483,9 +483,9 @@ public interface DeviceAgentService {
"Server error occurred while retrieving information requested device.", "Server error occurred while retrieving information requested device.",
response = ErrorResponse.class) response = ErrorResponse.class)
}) })
Response getNextPendingOperation(@ApiParam(name = "type", value = "The device type, such as ios, android or windows.", required = true) Response getNextPendingOperation(@ApiParam(name = "type", value = "The device type, such as ios, android, or windows.", required = true)
@PathParam("type") String type, @PathParam("type") String type,
@ApiParam(name = "id", value = "The device id.", required = true) @ApiParam(name = "id", value = "The device ID.", required = true)
@PathParam("id") String deviceId); @PathParam("id") String deviceId);
@PUT @PUT
@ -494,7 +494,7 @@ public interface DeviceAgentService {
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
consumes = MediaType.APPLICATION_JSON, consumes = MediaType.APPLICATION_JSON,
httpMethod = "PUT", httpMethod = "PUT",
value = "Update Operation", value = "Updating an Operation",
notes = "Update the Operations.", notes = "Update the Operations.",
tags = "Device Agent Management", tags = "Device Agent Management",
extensions = { extensions = {
@ -539,11 +539,11 @@ public interface DeviceAgentService {
"Server error occurred while retrieving information requested device.", "Server error occurred while retrieving information requested device.",
response = ErrorResponse.class) response = ErrorResponse.class)
}) })
Response updateOperation(@ApiParam(name = "type", value = "The device type, such as ios, android or windows.", required = true) Response updateOperation(@ApiParam(name = "type", value = "The device type, such as ios, android, or windows.", required = true)
@PathParam("type") String type, @PathParam("type") String type,
@ApiParam(name = "id", value = "The device id.", required = true) @ApiParam(name = "id", value = "The device ID.", required = true)
@PathParam("id") String deviceId, @PathParam("id") String deviceId,
@ApiParam(name = "operation", value = "Operation object with data.", required = true) @ApiParam(name = "operation", value = "Update the operation object with data.", required = true)
@Valid Operation operation); @Valid Operation operation);
@PUT @PUT
@ -552,7 +552,7 @@ public interface DeviceAgentService {
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
consumes = MediaType.APPLICATION_JSON, consumes = MediaType.APPLICATION_JSON,
httpMethod = "PUT", httpMethod = "PUT",
value = "Update Properties", value = "Updating Device Properties",
notes = "Update device properties.", notes = "Update device properties.",
tags = "Device Agent Management", tags = "Device Agent Management",
extensions = { extensions = {
@ -597,11 +597,11 @@ public interface DeviceAgentService {
"Server error occurred while retrieving information requested device.", "Server error occurred while retrieving information requested device.",
response = ErrorResponse.class) response = ErrorResponse.class)
}) })
Response updateDeviceProperties(@ApiParam(name = "type", value = "The device type, such as ios, android or windows.", required = true) Response updateDeviceProperties(@ApiParam(name = "type", value = "The device type, such as ios, android, or windows.", required = true)
@PathParam("type") String type, @PathParam("type") String type,
@ApiParam(name = "id", value = "The device id.", required = true) @ApiParam(name = "id", value = "The device ID.", required = true)
@PathParam("id") String deviceId, @PathParam("id") String deviceId,
@ApiParam(name = "properties", value = "device properties list.", required = true) @ApiParam(name = "properties", value = "The device properties list.", required = true)
@Valid List<Device.Property> properties); @Valid List<Device.Property> properties);
@GET @GET
@ -610,8 +610,8 @@ public interface DeviceAgentService {
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
consumes = MediaType.APPLICATION_JSON, consumes = MediaType.APPLICATION_JSON,
httpMethod = "GET", httpMethod = "GET",
value = "Get pending operation of the given device", value = "Getting Specific Operations of a Device",
notes = "Returns the Operations.", notes = "Device operations can be in the IN_PROGRESS, PENDING, COMPLETED, ERROR, or REPEATED status. You can use this API to get a list of all the operations that are in a specific status for a given device.",
tags = "Device Agent Management", tags = "Device Agent Management",
extensions = { extensions = {
@Extension(properties = { @Extension(properties = {
@ -656,9 +656,9 @@ public interface DeviceAgentService {
"Server error occurred while retrieving information requested device.", "Server error occurred while retrieving information requested device.",
response = ErrorResponse.class) response = ErrorResponse.class)
}) })
Response getOperationsByDeviceAndStatus(@ApiParam(name = "type", value = "The device type, such as ios, android or windows.", required = true) Response getOperationsByDeviceAndStatus(@ApiParam(name = "type", value = "The device type, such as ios, android, or windows.", required = true)
@PathParam("type") String type, @PathParam("type") String type,
@ApiParam(name = "id", value = "The device id.", required = true) @ApiParam(name = "id", value = "The device ID.", required = true)
@PathParam("id") String deviceId, @PathParam("id") String deviceId,
@ApiParam(name = "status", value = "status of the operation.", required = true) @ApiParam(name = "status", value = "status of the operation.", required = true)
@QueryParam("status")Operation.Status status); @QueryParam("status")Operation.Status status);

@ -77,8 +77,8 @@ public interface DeviceEventManagementService {
@ApiOperation( @ApiOperation(
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
httpMethod = "POST", httpMethod = "POST",
value = "Add Event Type Defnition", value = "Adding the Event Type Definition",
notes = "Add the event definition for the device.", notes = "Add the event definition for a device.",
tags = "Device Event Management", tags = "Device Event Management",
extensions = { extensions = {
@Extension(properties = { @Extension(properties = {
@ -120,9 +120,9 @@ public interface DeviceEventManagementService {
response = ErrorResponse.class) response = ErrorResponse.class)
} }
) )
Response deployDeviceTypeEventDefinition(@ApiParam(name = "type", value = "name of the device type", required = false) Response deployDeviceTypeEventDefinition(@ApiParam(name = "type", value = "The device type, such as android, ios, and windows.", required = false)
@PathParam("type")String deviceType, @PathParam("type")String deviceType,
@ApiParam(name = "deviceTypeEvent", value = "DeviceTypeEvent object with data.", required = true) @ApiParam(name = "deviceTypeEvent", value = "Add the data to complete the DeviceTypeEvent object.", required = true)
@Valid DeviceTypeEvent deviceTypeEvent); @Valid DeviceTypeEvent deviceTypeEvent);
@DELETE @DELETE
@ -130,8 +130,8 @@ public interface DeviceEventManagementService {
@ApiOperation( @ApiOperation(
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
httpMethod = "DELETE", httpMethod = "DELETE",
value = "Delete Event Type Defnition", value = "Delete Event Type Definition",
notes = "Delete the event definition for the device.", notes = "Delete the event definition of a device.",
tags = "Device Event Management", tags = "Device Event Management",
extensions = { extensions = {
@Extension(properties = { @Extension(properties = {
@ -173,7 +173,7 @@ public interface DeviceEventManagementService {
response = ErrorResponse.class) response = ErrorResponse.class)
} }
) )
Response deleteDeviceTypeEventDefinitions(@ApiParam(name = "type", value = "name of the device type", required = false) Response deleteDeviceTypeEventDefinitions(@ApiParam(name = "type", value = "The device type, such as android, ios, and windows.", required = false)
@PathParam("type")String deviceType); @PathParam("type")String deviceType);
@GET @GET
@ -244,7 +244,7 @@ public interface DeviceEventManagementService {
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
httpMethod = "GET", httpMethod = "GET",
value = "Getting Last Known Device Events", value = "Getting Last Known Device Events",
notes = "Get the Last Known events for the device.", notes = "Get the last known events for the device.",
tags = "Device Event Management", tags = "Device Event Management",
extensions = { extensions = {
@Extension(properties = { @Extension(properties = {
@ -287,9 +287,9 @@ public interface DeviceEventManagementService {
response = ErrorResponse.class) response = ErrorResponse.class)
} }
) )
Response getLastKnownData(@ApiParam(name = "deviceId", value = "id of the device ", required = false) Response getLastKnownData(@ApiParam(name = "deviceId", value = "The device ID.", required = false)
@PathParam("deviceId") String deviceId, @PathParam("deviceId") String deviceId,
@ApiParam(name = "type", value = "name of the device type", required = false) @ApiParam(name = "type", value = "The device type, such as android, ios, or windows.", required = false)
@PathParam("type") String deviceType); @PathParam("type") String deviceType);
@GET @GET
@ -297,7 +297,7 @@ public interface DeviceEventManagementService {
@ApiOperation( @ApiOperation(
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
httpMethod = "GET", httpMethod = "GET",
value = "Getting Event Type Defnition", value = "Getting Event Type Definition",
notes = "Get the event definition for the device.", notes = "Get the event definition for the device.",
tags = "Device Event Management", tags = "Device Event Management",
extensions = { extensions = {
@ -341,7 +341,7 @@ public interface DeviceEventManagementService {
response = ErrorResponse.class) response = ErrorResponse.class)
} }
) )
Response getDeviceTypeEventDefinition(@ApiParam(name = "type", value = "name of the device type", required = false) Response getDeviceTypeEventDefinition(@ApiParam(name = "type", value = "The type of the device, such as android, ios, or windows.", required = false)
@PathParam("type")String deviceType) ; @PathParam("type")String deviceType) ;
} }

@ -208,13 +208,13 @@ public interface DeviceManagementService {
Response getDevices( Response getDevices(
@ApiParam( @ApiParam(
name = "name", name = "name",
value = "The device name, such as shamu, bullhead or angler Nexus device names. ", value = "The device name. For example, Nexus devices can have names, suhc as shamu, bullhead or angler.",
required = false) required = false)
@Size(max = 45) @Size(max = 45)
String name, String name,
@ApiParam( @ApiParam(
name = "type", name = "type",
value = "The device type, such as ios, android or windows.", value = "The device type, such as ios, android, or windows.",
required = false) required = false)
@QueryParam("type") @QueryParam("type")
@Size(max = 45) @Size(max = 45)
@ -227,7 +227,7 @@ public interface DeviceManagementService {
String user, String user,
@ApiParam( @ApiParam(
name = "userPattern", name = "userPattern",
value = "The pattern of username of the owner of the device.", value = "Define a few letters of the username in the order they appear. For example, you want to get the devices that belong to the admin, you can give \\\"ad\\\" or \\\"min\\\" here and you will get the devices that are enrolled under a user who has the given combination as part of the username .",
required = false) required = false)
@QueryParam("userPattern") @QueryParam("userPattern")
String userPattern, String userPattern,
@ -303,8 +303,8 @@ public interface DeviceManagementService {
@ApiOperation( @ApiOperation(
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
httpMethod = "GET", httpMethod = "GET",
value = "Getting Details of Registered Devices owned by authenticated user", value = "Getting Details of Registered Devices Owned by an Authenticated User",
notes = "Provides details of devices enrolled by authenticated user.", notes = "Provides details of devices enrolled by authenticated users.",
tags = "Device Management", tags = "Device Management",
extensions = { extensions = {
@Extension(properties = { @Extension(properties = {
@ -460,8 +460,8 @@ public interface DeviceManagementService {
@ApiOperation( @ApiOperation(
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
httpMethod = "GET", httpMethod = "GET",
value = "Get device enrollment status", value = "Getting the Device Enrollment Status",
notes = "Get device enrollment status", notes = "Get the device enrollment status and the device details of the device.",
tags = "Device Management", tags = "Device Management",
extensions = { extensions = {
@Extension(properties = { @Extension(properties = {
@ -564,7 +564,7 @@ public interface DeviceManagementService {
Response getDeviceLocation( Response getDeviceLocation(
@ApiParam( @ApiParam(
name = "type", name = "type",
value = "The device type name, such as ios, android, windows or fire-alarm.", value = "The device type name, such as ios, android, windows, or fire-alarm.",
required = true) required = true)
@PathParam("type") @PathParam("type")
@Size(max = 45) @Size(max = 45)
@ -592,7 +592,7 @@ public interface DeviceManagementService {
@ApiOperation( @ApiOperation(
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
httpMethod = "GET", httpMethod = "GET",
value = "Getting the information of a Device", value = "Getting the Information of a Device",
notes = "Get the information of a device by specifying the device type and device identifier.", notes = "Get the information of a device by specifying the device type and device identifier.",
tags = "Device Management", tags = "Device Management",
extensions = { extensions = {
@ -641,7 +641,7 @@ public interface DeviceManagementService {
Response getDeviceInformation( Response getDeviceInformation(
@ApiParam( @ApiParam(
name = "type", name = "type",
value = "The device type name, such as ios, android, windows or fire-alarm.", value = "The device type name, such as ios, android, windows, or fire-alarm.",
required = true) required = true)
@PathParam("type") @PathParam("type")
@Size(max = 45) @Size(max = 45)
@ -670,8 +670,8 @@ public interface DeviceManagementService {
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
consumes = MediaType.APPLICATION_JSON, consumes = MediaType.APPLICATION_JSON,
httpMethod = "POST", httpMethod = "POST",
value = "Update the device specified by device id", value = "Update the Displayed Name of the Device",
notes = "Returns the status of the updated device operation.", notes = "Use this API to rename a device so that it is easy for you to identify devices.",
tags = "Device Management", tags = "Device Management",
extensions = { extensions = {
@Extension(properties = { @Extension(properties = {
@ -719,12 +719,12 @@ public interface DeviceManagementService {
Response renameDevice( Response renameDevice(
@ApiParam( @ApiParam(
name = "device", name = "device",
value = "The payload containing new name for device with updated name.", value = "The payload containing the new name of the device.",
required = true) required = true)
Device device, Device device,
@ApiParam( @ApiParam(
name = "device-type", name = "device-type",
value = "The device type, such as ios, android or windows.", value = "The device type, such as ios, android, or windows.",
required = true) required = true)
@PathParam("device-type") @PathParam("device-type")
@Size(max = 45) @Size(max = 45)
@ -745,8 +745,8 @@ public interface DeviceManagementService {
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
consumes = MediaType.APPLICATION_JSON, consumes = MediaType.APPLICATION_JSON,
httpMethod = "DELETE", httpMethod = "DELETE",
value = "Remove the device specified by device id", value = "Remove the Device Specified by the Device ID",
notes = "Returns the status of the deleted device operation.", notes = "Returns the status of the deleted device operation and the details of the deleted device.",
tags = "Device Management", tags = "Device Management",
extensions = { extensions = {
@Extension(properties = { @Extension(properties = {
@ -794,7 +794,7 @@ public interface DeviceManagementService {
Response deleteDevice( Response deleteDevice(
@ApiParam( @ApiParam(
name = "device-type", name = "device-type",
value = "The device type, such as ios, android or windows.", value = "The device type, such as ios, android, or windows.",
required = true) required = true)
@PathParam("device-type") @PathParam("device-type")
@Size(max = 45) @Size(max = 45)
@ -1041,7 +1041,7 @@ public interface DeviceManagementService {
Response getInstalledApplications( Response getInstalledApplications(
@ApiParam( @ApiParam(
name = "type", name = "type",
value = "The device type name, such as ios, android, windows or fire-alarm.", value = "The device type name, such as ios, android, windows, or fire-alarm.",
required = true) required = true)
@PathParam("type") @PathParam("type")
@Size(max = 45) @Size(max = 45)
@ -1190,7 +1190,7 @@ public interface DeviceManagementService {
@ApiOperation( @ApiOperation(
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
httpMethod = "GET", httpMethod = "GET",
value = "Get the details of the policy that is enforced on a device.", value = "Getting the Details of a Policy Enforced on a Device",
notes = "A policy is enforced on all the devices that register with WSO2 IoTS." + notes = "A policy is enforced on all the devices that register with WSO2 IoTS." +
"WSO2 IoTS filters the policies based on the device platform (device type)," + "WSO2 IoTS filters the policies based on the device platform (device type)," +
"the device ownership type, the user role or name and finally, the policy that matches these filters will be enforced on the device.", "the device ownership type, the user role or name and finally, the policy that matches these filters will be enforced on the device.",
@ -1252,14 +1252,14 @@ public interface DeviceManagementService {
Response getEffectivePolicyOfDevice( Response getEffectivePolicyOfDevice(
@ApiParam( @ApiParam(
name = "type", name = "type",
value = "The device type name, such as ios, android, windows or fire-alarm.", value = "The device type name, such as ios, android, windows, or fire-alarm.",
required = true) required = true)
@PathParam("type") @PathParam("type")
@Size(max = 45) @Size(max = 45)
String type, String type,
@ApiParam( @ApiParam(
name = "id", name = "id",
value = "The device identifier.", value = "The device ID.",
required = true) required = true)
@PathParam("id") @PathParam("id")
@Size(max = 45) @Size(max = 45)
@ -1327,8 +1327,8 @@ public interface DeviceManagementService {
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
consumes = MediaType.APPLICATION_JSON, consumes = MediaType.APPLICATION_JSON,
httpMethod = "PUT", httpMethod = "PUT",
value = "Change device status by device id.", value = "Changing the Status of a Device",
notes = "Returns the status of the changed device operation.", notes = "Change the status of a device from one state to another.",
tags = "Device Management", tags = "Device Management",
extensions = { extensions = {
@Extension(properties = { @Extension(properties = {
@ -1376,21 +1376,21 @@ public interface DeviceManagementService {
Response changeDeviceStatus( Response changeDeviceStatus(
@ApiParam( @ApiParam(
name = "type", name = "type",
value = "The device type, such as ios, android or windows.", value = "The device type, such as ios, android, or windows.",
required = true) required = true)
@PathParam("type") @PathParam("type")
@Size(max = 45) @Size(max = 45)
String type, String type,
@ApiParam( @ApiParam(
name = "id", name = "id",
value = "Device id", value = "Device ID.",
required = true) required = true)
@PathParam("id") @PathParam("id")
@Size(max = 45) @Size(max = 45)
String id, String id,
@ApiParam( @ApiParam(
name = "newStatus", name = "newStatus",
value = "New status of the device.", value = "The available device statuses are CREATED, ACTIVE, INACTIVE, UNREACHABLE, UNCLAIMED, SUSPENDED, BLOCKED, REMOVED, and DISENROLLMENT_REQUESTED.",
required = true) required = true)
@QueryParam("newStatus") @QueryParam("newStatus")
EnrolmentInfo.Status newStatus); EnrolmentInfo.Status newStatus);
@ -1401,8 +1401,8 @@ public interface DeviceManagementService {
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
consumes = MediaType.APPLICATION_JSON, consumes = MediaType.APPLICATION_JSON,
httpMethod = "POST", httpMethod = "POST",
value = "Add operation to set of devices for a given device type", value = "Sending an Operation to Specific Device Types",
notes = "Returns the Activity Related to the operation.", notes = "You can send an operation to a group of devices that belong to a specific device type using this API. For example, you can send a ring operation to all the enrolled Android devices.",
tags = "Device Management", tags = "Device Management",
extensions = { extensions = {
@Extension(properties = { @Extension(properties = {

@ -92,8 +92,8 @@ public interface GeoLocationBasedService {
consumes = "application/json", consumes = "application/json",
produces = "application/json", produces = "application/json",
httpMethod = "GET", httpMethod = "GET",
value = "Retrieve Analytics for the device type", value = "Getting the Location Details of a Device",
notes = "", notes = "Get the location details of a device during a define time period.",
response = Response.class, response = Response.class,
tags = "Geo Service Management", tags = "Geo Service Management",
extensions = { extensions = {
@ -131,24 +131,24 @@ public interface GeoLocationBasedService {
Response getGeoDeviceStats( Response getGeoDeviceStats(
@ApiParam( @ApiParam(
name = "deviceId", name = "deviceId",
value = "The registered device Id.", value = "The device ID.",
required = true) required = true)
@PathParam("deviceId") String deviceId, @PathParam("deviceId") String deviceId,
@ApiParam( @ApiParam(
name = "device-type", name = "device-type",
value = "The device type, such as ios, android or windows.", value = "The device type, such as ios, android, or windows.",
required = true) required = true)
@PathParam("deviceType") @PathParam("deviceType")
@Size(max = 45) @Size(max = 45)
String deviceType, String deviceType,
@ApiParam( @ApiParam(
name = "from", name = "from",
value = "Get stats from what time", value = "Define the time to start getting the geo location history of the device in the Epoch or UNIX format.",
required = true) required = true)
@QueryParam("from") long from, @QueryParam("from") long from,
@ApiParam( @ApiParam(
name = "to", name = "to",
value = "Get stats up to what time", value = "Define the time to finish getting the geo location history of the device in the Epoch or UNIX format.",
required = true) required = true)
@QueryParam("to") long to); @QueryParam("to") long to);
@ -161,8 +161,8 @@ public interface GeoLocationBasedService {
consumes = "application/json", consumes = "application/json",
produces = "application/json", produces = "application/json",
httpMethod = "GET", httpMethod = "GET",
value = "Retrieve locations of devices", value = "Getting the Devices in a Defined Geofence",
notes = "", notes = "Get the details of the devices that are within the defined geofence coordinates. The geofence you are defining is enclosed with four coordinates in the shape of a square or rectangle. This is done by defining two points of the geofence. The other two points are automatically created using the given points. You can define the zoom level or scale of the map too.",
response = Response.class, response = Response.class,
tags = "Geo Service Management", tags = "Geo Service Management",
extensions = { extensions = {
@ -200,28 +200,33 @@ public interface GeoLocationBasedService {
Response getGeoDeviceLocations( Response getGeoDeviceLocations(
@ApiParam( @ApiParam(
name = "minLat", name = "minLat",
value = "minimum latitude", value = "Define the minimum latitude of the geofence.",
required = true) required = true,
defaultValue ="79.85213577747345")
@QueryParam("minLat") double minLat, @QueryParam("minLat") double minLat,
@ApiParam( @ApiParam(
name = "maxLat", name = "maxLat",
value = "maxmimum latitude", value = "Define the maximum latitude of the geofence.",
required = true) required = true,
defaultValue ="79.85266149044037")
@QueryParam("maxLat") double maxLat, @QueryParam("maxLat") double maxLat,
@ApiParam( @ApiParam(
name = "minLong", name = "minLong",
value = "minimum longitude", value = "Define the minimum longitude of the geofence.",
required = true) required = true,
defaultValue ="6.909673257977737")
@QueryParam("minLong") double minLong, @QueryParam("minLong") double minLong,
@ApiParam( @ApiParam(
name = "maxLong", name = "maxLong",
value = "maximum longitudeude", value = "Define the maximum longitude of the geofence",
required = true) required = true,
defaultValue ="6.909673257977737")
@QueryParam("maxLong") double maxLong, @QueryParam("maxLong") double maxLong,
@ApiParam( @ApiParam(
name = "zoom", name = "zoom",
value = "zoom level", value = "Define the level to zoom or scale the map. You can define any value between 1 to 14.",
required = true) required = true,
defaultValue ="2")
@QueryParam("zoom") int zoom); @QueryParam("zoom") int zoom);
@ -233,9 +238,9 @@ public interface GeoLocationBasedService {
@ApiOperation( @ApiOperation(
consumes = "application/json", consumes = "application/json",
produces = "application/json", produces = "application/json",
httpMethod = "GET", httpMethod = "POST",
value = "Create Geo alerts for the device", value = "Retrieving a Specific Geo Alert Type from a Device",
notes = "", notes = "Retrieve a specific geo alert from a device, such as getting a speed alert that was sent to a device.",
response = Response.class, response = Response.class,
tags = "Geo Service Management", tags = "Geo Service Management",
extensions = { extensions = {
@ -274,19 +279,19 @@ public interface GeoLocationBasedService {
@Valid Alert alert, @Valid Alert alert,
@ApiParam( @ApiParam(
name = "deviceId", name = "deviceId",
value = "The registered device Id.", value = "The device ID.",
required = true) required = true)
@PathParam("deviceId") String deviceId, @PathParam("deviceId") String deviceId,
@ApiParam( @ApiParam(
name = "device-type", name = "device-type",
value = "The device type, such as ios, android or windows.", value = "The device type, such as ios, android, or windows.",
required = true) required = true)
@PathParam("deviceType") @PathParam("deviceType")
@Size(max = 45) @Size(max = 45)
String deviceType, String deviceType,
@ApiParam( @ApiParam(
name = "alertType", name = "alertType",
value = "The alert type, such as Within, Speed, Stationary", value = "The alert type, such as Within, Speed,Exit, or Stationary.",
required = true) required = true)
@PathParam("alertType") String alertType); @PathParam("alertType") String alertType);
@ -298,9 +303,9 @@ public interface GeoLocationBasedService {
@ApiOperation( @ApiOperation(
consumes = "application/json", consumes = "application/json",
produces = "application/json", produces = "application/json",
httpMethod = "GET", httpMethod = "PUT",
value = "Update Geo alerts for the device", value = "Updating the Geo Alerts of a Device",
notes = "", notes = "Update the a geo alert that was sent to a device.",
response = Response.class, response = Response.class,
tags = "Geo Service Management", tags = "Geo Service Management",
extensions = { extensions = {
@ -339,19 +344,19 @@ public interface GeoLocationBasedService {
@Valid Alert alert, @Valid Alert alert,
@ApiParam( @ApiParam(
name = "deviceId", name = "deviceId",
value = "The registered device Id.", value = "The device ID.",
required = true) required = true)
@PathParam("deviceId") String deviceId, @PathParam("deviceId") String deviceId,
@ApiParam( @ApiParam(
name = "device-type", name = "device-type",
value = "The device type, such as ios, android or windows.", value = "The device type, such as ios, android, or windows.",
required = true) required = true)
@PathParam("deviceType") @PathParam("deviceType")
@Size(max = 45) @Size(max = 45)
String deviceType, String deviceType,
@ApiParam( @ApiParam(
name = "alertType", name = "alertType",
value = "The alert type, such as Within, Speed, Stationary", value = "The alert type, such as Within, Speed, Exit, or Stationary",
required = true) required = true)
@PathParam("alertType") String alertType); @PathParam("alertType") String alertType);
@ -364,8 +369,8 @@ public interface GeoLocationBasedService {
consumes = "application/json", consumes = "application/json",
produces = "application/json", produces = "application/json",
httpMethod = "GET", httpMethod = "GET",
value = "Retrieve Geo alerts for the device", value = "Getting a Geo Alert from a Device",
notes = "", notes = "Retrieve a specific geo alert from a device, such as getting a speed alert that was sent to a device.",
response = Response.class, response = Response.class,
tags = "Geo Service Management", tags = "Geo Service Management",
extensions = { extensions = {
@ -403,19 +408,19 @@ public interface GeoLocationBasedService {
Response getGeoAlerts( Response getGeoAlerts(
@ApiParam( @ApiParam(
name = "deviceId", name = "deviceId",
value = "The registered device Id.", value = "The device ID.",
required = true) required = true)
@PathParam("deviceId") String deviceId, @PathParam("deviceId") String deviceId,
@ApiParam( @ApiParam(
name = "device-type", name = "device-type",
value = "The device type, such as ios, android or windows.", value = "The device type, such as ios, android. or windows.",
required = true) required = true)
@PathParam("deviceType") @PathParam("deviceType")
@Size(max = 45) @Size(max = 45)
String deviceType, String deviceType,
@ApiParam( @ApiParam(
name = "alertType", name = "alertType",
value = "The alert type, such as Within, Speed, Stationary", value = "The alert type, such as Within, Speed, Exit, or Stationary",
required = true) required = true)
@PathParam("alertType") String alertType); @PathParam("alertType") String alertType);
@ -428,8 +433,8 @@ public interface GeoLocationBasedService {
consumes = "application/json", consumes = "application/json",
produces = "application/json", produces = "application/json",
httpMethod = "GET", httpMethod = "GET",
value = "Retrieve Geo alerts history for the device", value = "Getting the Geo Service Alert History of a Device",
notes = "", notes = "Get the geo alert history of a device during the defined time period.",
response = Response.class, response = Response.class,
tags = "Geo Service Management", tags = "Geo Service Management",
extensions = { extensions = {
@ -467,24 +472,24 @@ public interface GeoLocationBasedService {
Response getGeoAlertsHistory( Response getGeoAlertsHistory(
@ApiParam( @ApiParam(
name = "deviceId", name = "deviceId",
value = "The registered device Id.", value = "The device ID.",
required = true) required = true)
@PathParam("deviceId") String deviceId, @PathParam("deviceId") String deviceId,
@ApiParam( @ApiParam(
name = "device-type", name = "device-type",
value = "The device type, such as ios, android or windows.", value = "The device type, such as ios, android, or windows.",
required = true) required = true)
@PathParam("deviceType") @PathParam("deviceType")
@Size(max = 45) @Size(max = 45)
String deviceType, String deviceType,
@ApiParam( @ApiParam(
name = "from", name = "from",
value = "Get stats from what time", value = "Define the time to start getting the geo location history of the device in the Epoch or UNIX format.",
required = true) required = true)
@QueryParam("from") long from, @QueryParam("from") long from,
@ApiParam( @ApiParam(
name = "to", name = "to",
value = "Get stats up to what time", value = "Define the time to finish getting the geo location history of the device in the Epoch or UNIX format.",
required = true) required = true)
@QueryParam("to") long to); @QueryParam("to") long to);
@ -494,8 +499,8 @@ public interface GeoLocationBasedService {
consumes = "application/json", consumes = "application/json",
produces = "application/json", produces = "application/json",
httpMethod = "DELETE", httpMethod = "DELETE",
value = "Deletes Geo alerts for the device", value = "Deleting a Geo Alert from a Device",
notes = "", notes = "Delete a specific geo alert from a device, such as deleting a speed alert that was sent to the device.",
response = Response.class, response = Response.class,
tags = "Geo Service Management", tags = "Geo Service Management",
extensions = { extensions = {
@ -529,22 +534,22 @@ public interface GeoLocationBasedService {
Response removeGeoAlerts( Response removeGeoAlerts(
@ApiParam( @ApiParam(
name = "deviceId", name = "deviceId",
value = "The registered device Id.", value = "The device ID.",
required = true) required = true)
@PathParam("deviceId") String deviceId, @PathParam("deviceId") String deviceId,
@ApiParam( @ApiParam(
name = "deviceType", name = "deviceType",
value = "The device type, such as ios, android or windows.", value = "The device type, such as ios, android, or windows.",
required = true) required = true)
@PathParam("deviceType") String deviceType, @PathParam("deviceType") String deviceType,
@ApiParam( @ApiParam(
name = "alertType", name = "alertType",
value = "The alert type, such as Within, Speed, Stationary", value = "The alert type, such as Within, Speed, Exit, or Stationary",
required = true) required = true)
@PathParam("alertType") String alertType, @PathParam("alertType") String alertType,
@ApiParam( @ApiParam(
name = "queryName", name = "queryName",
value = "The query name.", value = "When you define a geofence you define a fence name for it. That name needs to be defined here.",
required = true) required = true)
@QueryParam("queryName") String queryName); @QueryParam("queryName") String queryName);
} }

@ -175,8 +175,8 @@ public interface GroupManagementService {
@ApiOperation( @ApiOperation(
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
httpMethod = HTTPConstants.HEADER_GET, httpMethod = HTTPConstants.HEADER_GET,
value = "Get the list of groups belongs to current user.", value = "Getting the List of Groups",
notes = "Returns all permitted groups enrolled with the system.", notes = "Returns all groups enrolled with the system.",
tags = "Device Group Management", tags = "Device Group Management",
extensions = { extensions = {
@Extension(properties = { @Extension(properties = {
@ -240,8 +240,8 @@ public interface GroupManagementService {
@ApiOperation( @ApiOperation(
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
httpMethod = HTTPConstants.HEADER_GET, httpMethod = HTTPConstants.HEADER_GET,
value = "Get the count of groups belongs to current user.", value = "Getting the Number of Device Groups",
notes = "Returns count of all permitted groups enrolled with the system.", notes = "Get the number of device groups in the server that the current signed in user can access.",
tags = "Device Group Management", tags = "Device Group Management",
extensions = { extensions = {
@Extension(properties = { @Extension(properties = {
@ -284,8 +284,8 @@ public interface GroupManagementService {
@ApiOperation( @ApiOperation(
consumes = MediaType.APPLICATION_JSON, consumes = MediaType.APPLICATION_JSON,
httpMethod = HTTPConstants.HEADER_POST, httpMethod = HTTPConstants.HEADER_POST,
value = "Add new device group to the system.", value = "Adding a New Device Group",
notes = "Add device group with current user as the owner.", notes = "Add device group with the current user as the owner.",
tags = "Device Group Management", tags = "Device Group Management",
extensions = { extensions = {
@Extension(properties = { @Extension(properties = {
@ -341,7 +341,7 @@ public interface GroupManagementService {
}) })
Response createGroup(@ApiParam( Response createGroup(@ApiParam(
name = "group", name = "group",
value = "Group object with data.", value = "Define the group object with data.",
required = true) required = true)
@Valid DeviceGroup group); @Valid DeviceGroup group);
@ -350,8 +350,8 @@ public interface GroupManagementService {
@ApiOperation( @ApiOperation(
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
httpMethod = HTTPConstants.HEADER_GET, httpMethod = HTTPConstants.HEADER_GET,
value = "View group specified.", value = "Getting Details of a Specific Device Group",
notes = "Returns details of group enrolled with the system.", notes = "Get the details of a specific device group.",
tags = "Device Group Management", tags = "Device Group Management",
extensions = { extensions = {
@Extension(properties = { @Extension(properties = {
@ -393,7 +393,7 @@ public interface GroupManagementService {
}) })
Response getGroup(@ApiParam( Response getGroup(@ApiParam(
name = "groupId", name = "groupId",
value = "ID of the group to view.", value = "The ID of the group.",
required = true) required = true)
@PathParam("groupId") int groupId); @PathParam("groupId") int groupId);
@ -402,9 +402,8 @@ public interface GroupManagementService {
@ApiOperation( @ApiOperation(
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
httpMethod = HTTPConstants.HEADER_PUT, httpMethod = HTTPConstants.HEADER_PUT,
value = "Update a group.", value = "Updating a Device Group",
notes = "If you wish to make changes to an existing group, that can be done by updating the group using " + notes = "If you wish to make changes to an existing group, that can be done by updating the group using this API",
"this resource.",
tags = "Device Group Management", tags = "Device Group Management",
extensions = { extensions = {
@Extension(properties = { @Extension(properties = {
@ -450,7 +449,7 @@ public interface GroupManagementService {
@PathParam("groupId") int groupId, @PathParam("groupId") int groupId,
@ApiParam( @ApiParam(
name = "group", name = "group",
value = "Group object with data.", value = "Update the content of the group object.",
required = true) required = true)
@Valid DeviceGroup deviceGroup); @Valid DeviceGroup deviceGroup);
@ -459,9 +458,8 @@ public interface GroupManagementService {
@ApiOperation( @ApiOperation(
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
httpMethod = HTTPConstants.HEADER_DELETE, httpMethod = HTTPConstants.HEADER_DELETE,
value = "Delete a group.", value = "Deleting a Group",
notes = "If you wish to remove an existing group, that can be done by updating the group using " + notes = "If you wish to remove an existing group, that can be done by updating the group using this API.",
"this resource.",
tags = "Device Group Management", tags = "Device Group Management",
extensions = { extensions = {
@Extension(properties = { @Extension(properties = {
@ -511,9 +509,8 @@ public interface GroupManagementService {
@ApiOperation( @ApiOperation(
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
httpMethod = HTTPConstants.HEADER_POST, httpMethod = HTTPConstants.HEADER_POST,
value = "Manage group sharing with a user.", value = "Sharing a Group",
notes = "If you wish to share /un share an existing group with a user under defined sharing roles, " + notes = "A device group can be shared with different user-roles. The users that belong to that role can then view the groups and the devices in it. Use this API to share a group among user roles.",
"that can be done using this resource.",
tags = "Device Group Management", tags = "Device Group Management",
extensions = { extensions = {
@Extension(properties = { @Extension(properties = {
@ -568,8 +565,8 @@ public interface GroupManagementService {
@ApiOperation( @ApiOperation(
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
httpMethod = HTTPConstants.HEADER_GET, httpMethod = HTTPConstants.HEADER_GET,
value = "View list of roles of a device group.", value = "Getting the List of Roles the Group is Shared With",
notes = "Returns details of roles which particular group has been shared with.", notes = "A device group can be shared with different user-roles. The users that belong to that role can then view the groups and the devices in it. Using this API you get the list of roles the device group is shared with.",
tags = "Device Group Management", tags = "Device Group Management",
extensions = { extensions = {
@Extension(properties = { @Extension(properties = {
@ -620,8 +617,8 @@ public interface GroupManagementService {
@ApiOperation( @ApiOperation(
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
httpMethod = HTTPConstants.HEADER_GET, httpMethod = HTTPConstants.HEADER_GET,
value = "View list of devices in the device group.", value = "Getting the List of Devices in a Group",
notes = "Returns list of devices in the device group.", notes = "Returns the list of devices in a device group.",
tags = "Device Group Management", tags = "Device Group Management",
extensions = { extensions = {
@Extension(properties = { @Extension(properties = {
@ -675,7 +672,7 @@ public interface GroupManagementService {
int offset, int offset,
@ApiParam( @ApiParam(
name = "limit", name = "limit",
value = "Provide how many device details you require from the starting pagination index/offset.", value = "Provide how many group details you require from the starting pagination index/offset.",
defaultValue = "5") defaultValue = "5")
@QueryParam("limit") @QueryParam("limit")
int limit); int limit);
@ -685,8 +682,8 @@ public interface GroupManagementService {
@ApiOperation( @ApiOperation(
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
httpMethod = HTTPConstants.HEADER_GET, httpMethod = HTTPConstants.HEADER_GET,
value = "View list of device count in the device group.", value = "Getting the Number of Devices in a Group",
notes = "Returns device count in the device group.", notes = "Get the number of devices in a group using this API.",
tags = "Device Group Management", tags = "Device Group Management",
extensions = { extensions = {
@Extension(properties = { @Extension(properties = {
@ -737,8 +734,8 @@ public interface GroupManagementService {
@ApiOperation( @ApiOperation(
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
httpMethod = HTTPConstants.HEADER_POST, httpMethod = HTTPConstants.HEADER_POST,
value = "Add devices to group.", value = "Adding Devices to Group",
notes = "Add existing devices to the device group.", notes = "Add the enrolled devices to a group.",
tags = "Device Group Management", tags = "Device Group Management",
extensions = { extensions = {
@Extension(properties = { @Extension(properties = {
@ -793,8 +790,8 @@ public interface GroupManagementService {
@ApiOperation( @ApiOperation(
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
httpMethod = HTTPConstants.HEADER_DELETE, httpMethod = HTTPConstants.HEADER_DELETE,
value = "Remove devices from group.", value = "Removing Devices from a Group",
notes = "Remove existing devices from the device group.", notes = "Remove a device from a group using this API.",
tags = "Device Group Management", tags = "Device Group Management",
extensions = { extensions = {
@Extension(properties = { @Extension(properties = {
@ -840,7 +837,7 @@ public interface GroupManagementService {
@PathParam("groupId") int groupId, @PathParam("groupId") int groupId,
@ApiParam( @ApiParam(
name = "deviceIdentifiers", name = "deviceIdentifiers",
value = "Device identifiers of the devices which needed to be removed.", value = "The device identifiers of the devices that needed to be removed. You can define many device IDs as comma separated values.",
required = true) required = true)
@Valid List<DeviceIdentifier> deviceIdentifiers); @Valid List<DeviceIdentifier> deviceIdentifiers);
@ -849,8 +846,8 @@ public interface GroupManagementService {
@ApiOperation( @ApiOperation(
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
httpMethod = HTTPConstants.HEADER_POST, httpMethod = HTTPConstants.HEADER_POST,
value = "Assign devices to groups", value = "Adding Devices to a Group",
notes = "Add existing device to device groups.", notes = "Add the existing devices to a device groups.",
tags = "Device Group Management", tags = "Device Group Management",
extensions = { extensions = {
@Extension(properties = { @Extension(properties = {
@ -892,7 +889,7 @@ public interface GroupManagementService {
Response updateDeviceAssigningToGroups( Response updateDeviceAssigningToGroups(
@ApiParam( @ApiParam(
name = "deviceToGroupsAssignment", name = "deviceToGroupsAssignment",
value = "Device to groups assignment", value = "Define the group ID and the device identifiers of the devices that need to be added to the group in the payload.",
required = true) required = true)
@Valid DeviceToGroupsAssignment deviceToGroupsAssignment); @Valid DeviceToGroupsAssignment deviceToGroupsAssignment);
@ -901,8 +898,8 @@ public interface GroupManagementService {
@ApiOperation( @ApiOperation(
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
httpMethod = HTTPConstants.HEADER_GET, httpMethod = HTTPConstants.HEADER_GET,
value = "List of groups that have the device", value = "Getting Device Groups that Include the Specific Device",
notes = "List of groups that have the device.", notes = " device can be added to one or many groups. This API gives you the list of groups the device has been added to.",
tags = "Device Group Management", tags = "Device Group Management",
extensions = { extensions = {
@Extension(properties = { @Extension(properties = {
@ -940,13 +937,13 @@ public interface GroupManagementService {
Response getGroups( Response getGroups(
@ApiParam( @ApiParam(
name = "deviceId", name = "deviceId",
value = "Id of the device.", value = "The device ID.",
required = true) required = true)
@QueryParam("deviceId") @QueryParam("deviceId")
String deviceId, String deviceId,
@ApiParam( @ApiParam(
name = "deviceType", name = "deviceType",
value = "Type of the device.", value = "The type of the device, such as android, ios, or windows.",
required = true) required = true)
@QueryParam("deviceType") @QueryParam("deviceType")
String deviceType); String deviceType);

@ -221,9 +221,9 @@ public interface NotificationManagementService {
@ApiOperation( @ApiOperation(
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
httpMethod = "PUT", httpMethod = "PUT",
value = "Clear all notifications", value = "Clearing All Notifications",
notes = "When a user needs to mark all the notifications as checked/read this " + notes = "When a user needs to mark all the notifications as checked/read this " +
"function can be used to clear all notifications", "function can be used to clear all notifications.",
tags = "Device Notification Management", tags = "Device Notification Management",
extensions = { extensions = {
@Extension(properties = { @Extension(properties = {

@ -78,8 +78,8 @@ public interface RemoteSessionService {
consumes = "application/json", consumes = "application/json",
produces = "application/json", produces = "application/json",
httpMethod = "GET", httpMethod = "GET",
value = "Retrieve Connection Information for the device type", value = "Connecting to a Device",
notes = "", notes = "You able to connect to a device to start a remote session using this API.",
response = Response.class, response = Response.class,
tags = "Remote Session Service Management", tags = "Remote Session Service Management",
extensions = { extensions = {
@ -117,12 +117,12 @@ public interface RemoteSessionService {
Response getRemoteSessionDeviceConnect( Response getRemoteSessionDeviceConnect(
@ApiParam( @ApiParam(
name = "deviceId", name = "deviceId",
value = "The registered device Id.", value = "The device ID.",
required = true) required = true)
@PathParam("deviceId") String deviceId, @PathParam("deviceId") String deviceId,
@ApiParam( @ApiParam(
name = "device-type", name = "device-type",
value = "The device type, such as ios, android or windows.", value = "The device type, such as ios, android, or windows.",
required = true) required = true)
@PathParam("deviceType") @PathParam("deviceType")
@Size(max = 45) @Size(max = 45)

@ -185,7 +185,7 @@ public interface RoleManagementService {
@ApiOperation( @ApiOperation(
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
httpMethod = "GET", httpMethod = "GET",
value = "Getting the List of Roles filtered by the given prefix", value = "Getting the List of Roles Filtered by the Given Prefix",
notes = "WSO2 IoTS supports role-based access control (RBAC) and role management. Using this API you can the list of roles that are in WSO2 IoTS.\n" + notes = "WSO2 IoTS supports role-based access control (RBAC) and role management. Using this API you can the list of roles that are in WSO2 IoTS.\n" +
"Note: Internal roles, roles created for service-providers, and application related roles will not be given in the output.", "Note: Internal roles, roles created for service-providers, and application related roles will not be given in the output.",
tags = "Role Management", tags = "Role Management",
@ -482,7 +482,7 @@ public interface RoleManagementService {
produces = MediaType.APPLICATION_JSON, produces = MediaType.APPLICATION_JSON,
httpMethod = "POST", httpMethod = "POST",
value = "Adding a combined Role", value = "Adding a combined Role",
notes = "WSO2 IoTS supports role-based access control (RBAC) and role management. Add a new combined role to WSO2 IoTS using this REST API.", notes = "You are able to combine two roles that already exist and create one role. For example, you might want a role that has device owner and application management role permissions, you can now select these two roles and create another new role that has all their permissions.",
tags = "Role Management", tags = "Role Management",
extensions = { extensions = {
@Extension(properties = { @Extension(properties = {

Loading…
Cancel
Save