Get Beacon by ID
The Get Beacon by ID API accepts the beacon ID as input parameter and responds with a beacon details.
URL
The HTTP URL for Get Beacon by ID API is:
http://<<host>>:<<port>>/api/v1/beacon/{id}
This service implements Gateway Filter for Authentication to authenticate access of the service by a user.
Method
GET
Output Parameters
The following fields are output parameters:
| Output Parameter | Type | Description |
|---|---|---|
| id | long | Unique ID assigned to a beacon |
| name | string | The unique name assigned to a beacon |
| details | string | Description of the beacon |
| uuid | alphanumeric | Universally Unique Identifier Number (UUID) assigned to the Beacon. UUID contains 32 hexadecimal digits, split into 5 groups, and separated by dashes, for example, f7826da6-4fa2-4e98-8024- bc5b71e0893e |
| major | long | Major ID is a major identifier of a Bluetooth beacon |
| minor | long | Minor ID is a minor identifier of a Bluetooth beacon |
| createdBy | string | A user name that shows who created the beacon |
| lastModifiedBy | string | A user name that shows who last modified the beacon |
| lastModifiedDateStr | string | Date on which the beacon was last modified |
| isDeleted | boolean | The IsDeleted property indicates whether the beacon is deleted or not |
| createdDateStr | string | Date on which the beacon is created |
Sample Response
{
"id" : 3,
"name" : "BeaconCreateName",
"details" : "BeaconCreateDetails",
"uuid" : "Beacon-Create-UUID",
"major" : 500,
"minor" : 100,
"createdBy" : "admin",
"lastModifiedBy" : "admin",
"lastModifiedDateStr" : "08/02/2016 11:36:51 AM EDT",
"isDeleted" : false,
"createdDateStr" : "08/02/2016 11:36:51 AM EDT"
}
Response Status
| Code | Description |
|---|---|
| Status 200 | Array of beacon details |
| Status 400 | Invalid beacon ID provided or no beacon found with the ID |
| Status 401 | Unauthorized request |
| Status 500 | Server failure to process request. |