Modify Beacon by ID
The Modify Beacon by ID API modifies the details of a beacon.
URL
The HTTP URL for Modify 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
PUT
Header
The payload's request header includes Content-Type as application/json;charset=UTF-8.
Input Parameters
The following fields are input parameters:
| Input Parameter | Required | Type | Description |
|---|---|---|---|
| name | Yes | string | The unique name assigned to a beacon |
| details | Optional | string | Description of the beacon |
| uuid | Yes | 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 | Optional | long | Major ID is a major identifier of a Bluetooth beacon |
| minor | Optional | long | Minor ID is a minor identifier of a Bluetooth beacon |
Sample Request
{
"name": "BeaconCreateName",
"details": "BeaconCreateDetails",
"uuid": "Beacon-Create-UUID",
"major": "123",
"minor": "234"
}
Output Parameters
The following fields are output parameters:
| Output Parameter | Type | Description |
|---|---|---|
| id | int | Unique ID assigned to a beacon |
| message | string | Response status message |
Sample Response
{
"message" : "Details updated successfully",
"id" : "beaconId"
}
Response Status
| Code | Description |
|---|---|
| Status 200 | Details updated successfully |
| Status 400 | Invalid request. Request method not allowedAuthentication fail, Invalid credentials |
| Status 401 | Unauthorized request. |
| Status 500 | Server failure to process request. |