@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 {
ResponsegetActivity(
ResponsegetActivity(
@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 {
ResponsegetActivities(
ResponsegetActivities(
@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")ActivityIdListactivityIdList);
@QueryParam("ids")ActivityIdListactivityIdList);
@ -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 {
Stringid,
Stringid,
@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.",
@ -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 nota 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)
})
})
ResponseenrollDevice(@ApiParam(name="device",value="Device object with data.",required=true)
ResponseenrollDevice(@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)
@ValidDevicedevice);
@ValidDevicedevice);
@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.")
@ -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)
})
})
ResponsegetOperationsByDeviceAndStatus(@ApiParam(name="type",value="The device type, such as ios, android or windows.",required=true)
ResponsegetOperationsByDeviceAndStatus(@ApiParam(name="type",value="The device type, such as ios, android, or windows.",required=true)
@ -208,13 +208,13 @@ public interface DeviceManagementService {
ResponsegetDevices(
ResponsegetDevices(
@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)
Stringname,
Stringname,
@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 {
Stringuser,
Stringuser,
@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")
StringuserPattern,
StringuserPattern,
@ -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 {
ResponsegetDeviceLocation(
ResponsegetDeviceLocation(
@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 {
ResponsegetDeviceInformation(
ResponsegetDeviceInformation(
@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 {
ResponserenameDevice(
ResponserenameDevice(
@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)
Devicedevice,
Devicedevice,
@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 {
ResponsedeleteDevice(
ResponsedeleteDevice(
@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 {
ResponsegetInstalledApplications(
ResponsegetInstalledApplications(
@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 {
ResponsegetEffectivePolicyOfDevice(
ResponsegetEffectivePolicyOfDevice(
@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)
Stringtype,
Stringtype,
@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 {
ResponsechangeDeviceStatus(
ResponsechangeDeviceStatus(
@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)
Stringtype,
Stringtype,
@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)
Stringid,
Stringid,
@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.StatusnewStatus);
EnrolmentInfo.StatusnewStatus);
@ -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.",
@ -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 {
ResponsegetGeoDeviceStats(
ResponsegetGeoDeviceStats(
@ApiParam(
@ApiParam(
name="deviceId",
name="deviceId",
value="The registered device Id.",
value="The device ID.",
required=true)
required=true)
@PathParam("deviceId")StringdeviceId,
@PathParam("deviceId")StringdeviceId,
@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)
StringdeviceType,
StringdeviceType,
@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")longfrom,
@QueryParam("from")longfrom,
@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")longto);
@QueryParam("to")longto);
@ -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 {
ResponsegetGeoDeviceLocations(
ResponsegetGeoDeviceLocations(
@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")doubleminLat,
@QueryParam("minLat")doubleminLat,
@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")doublemaxLat,
@QueryParam("maxLat")doublemaxLat,
@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")doubleminLong,
@QueryParam("minLong")doubleminLong,
@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")doublemaxLong,
@QueryParam("maxLong")doublemaxLong,
@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")intzoom);
@QueryParam("zoom")intzoom);
@ -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 {
@ValidAlertalert,
@ValidAlertalert,
@ApiParam(
@ApiParam(
name="deviceId",
name="deviceId",
value="The registered device Id.",
value="The device ID.",
required=true)
required=true)
@PathParam("deviceId")StringdeviceId,
@PathParam("deviceId")StringdeviceId,
@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)
StringdeviceType,
StringdeviceType,
@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")StringalertType);
@PathParam("alertType")StringalertType);
@ -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 {
@ValidAlertalert,
@ValidAlertalert,
@ApiParam(
@ApiParam(
name="deviceId",
name="deviceId",
value="The registered device Id.",
value="The device ID.",
required=true)
required=true)
@PathParam("deviceId")StringdeviceId,
@PathParam("deviceId")StringdeviceId,
@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)
StringdeviceType,
StringdeviceType,
@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")StringalertType);
@PathParam("alertType")StringalertType);
@ -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 {
ResponsegetGeoAlerts(
ResponsegetGeoAlerts(
@ApiParam(
@ApiParam(
name="deviceId",
name="deviceId",
value="The registered device Id.",
value="The device ID.",
required=true)
required=true)
@PathParam("deviceId")StringdeviceId,
@PathParam("deviceId")StringdeviceId,
@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)
StringdeviceType,
StringdeviceType,
@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")StringalertType);
@PathParam("alertType")StringalertType);
@ -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 {
ResponsegetGeoAlertsHistory(
ResponsegetGeoAlertsHistory(
@ApiParam(
@ApiParam(
name="deviceId",
name="deviceId",
value="The registered device Id.",
value="The device ID.",
required=true)
required=true)
@PathParam("deviceId")StringdeviceId,
@PathParam("deviceId")StringdeviceId,
@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)
StringdeviceType,
StringdeviceType,
@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")longfrom,
@QueryParam("from")longfrom,
@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")longto);
@QueryParam("to")longto);
@ -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 {
ResponseremoveGeoAlerts(
ResponseremoveGeoAlerts(
@ApiParam(
@ApiParam(
name="deviceId",
name="deviceId",
value="The registered device Id.",
value="The device ID.",
required=true)
required=true)
@PathParam("deviceId")StringdeviceId,
@PathParam("deviceId")StringdeviceId,
@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")StringdeviceType,
@PathParam("deviceType")StringdeviceType,
@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")StringalertType,
@PathParam("alertType")StringalertType,
@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.",
@ -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 {
})
})
ResponsecreateGroup(@ApiParam(
ResponsecreateGroup(@ApiParam(
name="group",
name="group",
value="Group object with data.",
value="Define the group object with data.",
required=true)
required=true)
@ValidDeviceGroupgroup);
@ValidDeviceGroupgroup);
@ -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 {
})
})
ResponsegetGroup(@ApiParam(
ResponsegetGroup(@ApiParam(
name="groupId",
name="groupId",
value="ID of the group to view.",
value="The ID of the group.",
required=true)
required=true)
@PathParam("groupId")intgroupId);
@PathParam("groupId")intgroupId);
@ -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")intgroupId,
@PathParam("groupId")intgroupId,
@ApiParam(
@ApiParam(
name="group",
name="group",
value="Group object with data.",
value="Update the content of the group object.",
required=true)
required=true)
@ValidDeviceGroupdeviceGroup);
@ValidDeviceGroupdeviceGroup);
@ -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 {
intoffset,
intoffset,
@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")
intlimit);
intlimit);
@ -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")intgroupId,
@PathParam("groupId")intgroupId,
@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)
@ValidList<DeviceIdentifier>deviceIdentifiers);
@ValidList<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 {
ResponseupdateDeviceAssigningToGroups(
ResponseupdateDeviceAssigningToGroups(
@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.",
@ -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.",
lasantha
7 years ago