Assets Management in Senitron
Method 1: Push API JSON List | Show | Create | Update | Destroy
Method 1: Push API JSON List | Show | Create | Update | Destroy
Get List of Assets
METHOD: GET
URL: {tenant}/{location}/api/v1/assets
PARAMETERS:
api_key=xxxxxxxxxx
query=<serial#, alt-serial or EPC value>
page=1
pre_page=20
Note:
- query parameter value do search on serial#, alt-serial and EPC
REQUEST BODY:
None
RESPONSE BODY:
Success (Status Code: 200)
{ "pagination": { "current_page": 1, "per_page": 20, "total_entries": 1 }, "assets": [ { "id": 342, "serial_number": "63402", "item_number": "213000891211", "alt_serial": "", "epc": "2938000000000000000003FE", "first_seen": "05/22/23 11:09 AM", "last_seen": "05/22/23 11:09 AM", "last_seen_antenna": "", "last_zone": "", "handheld_reader": "HH-471", "handheld_last_seen": "05/22/2023 11:09 AM", "current_units": 1.0, "storage_unit": 1.0, "adjust_qty": 0, "attr1": "", "attr2": "", "attr3": "", "attr4": "", "attr5": "", "attr6": "", "attr7": "", "attr8": "", "attr9": "", "attr10": "", "created_at": "05/15/23 01:17 PM", "updated_at": "05/22/23 11:09 AM", "status": { "id": 1005, "name": "Pending Visibility" }, "static_zone": "", "static_zone_last_update": "", } ] }
Error (Status Code: 401)
{ "status": "error", "message": "Invalid API key" }
Get Asset
METHOD: GET
URL: {tenant}/{location}/api/v1/assets/(id)
PARAMETERS:
api_key=xxxxxxxxxx
REQUEST BODY:
None
RESPONSE BODY:
Success (Status Code: 200)
{ "id": 342, "serial_number": "63402", "item_number": "213000891211", "alt_serial": "", "epc": "2938000000000000000003FE", "first_seen": "05/22/23 11:09 AM", "last_seen": "05/22/23 11:09 AM", "last_seen_antenna": "", "last_zone": "", "handheld_reader": "HH-471", "handheld_last_seen": "05/22/2023 11:09 AM", "current_units": 1.0, "storage_unit": 1.0, "adjust_qty": 0, "attr1": "", "attr2": "", "attr3": "", "attr4": "", "attr5": "", "attr6": "", "attr7": "", "attr8": "", "attr9": "", "attr10": "", "created_at": "05/15/23 01:17 PM", "updated_at": "05/22/23 11:09 AM", "status": { "id": 1005, "name": "Pending Visibility" }, "static_zone": "", "static_zone_last_update": "" }
Error (Status Code: 401)
{ "status": "error", "message": "Invalid API key" }
Error (Status Code: 404)
{ "status": "error", "message": "The asset ID is not valid" }
Create New Asset
METHOD: POST
URL: {tenant}/{location}/api/v1/assets
PARAMETERS:
api_key=xxxxxxxxxx
REQUEST BODY:
{ "item_number": "213000891211", "alt_serial": "", "current_units": 1.0, "storage_unit": 1.0, "adjust_qty": 0, "attr1": "", "attr2": "", "attr3": "", "attr4": "", "attr5": "", "attr6": "", "attr7": "", "attr8": "", "attr9": "", "attr10": "" }
RESPONSE BODY:
Success (Status Code: 200)
{ "message": "The asset created succesfully", "asset": { "id": 342, "serial_number": "63402", "item_number": "213000891211", "alt_serial": "", "epc": "2938000000000000000003FE", "first_seen": "05/22/23 11:09 AM", "last_seen": "05/22/23 11:09 AM", "last_seen_antenna": "", "last_zone": "", "handheld_reader": "HH-471", "handheld_last_seen": "05/22/2023 11:09 AM", "current_units": 1.0, "storage_unit": 1.0, "adjust_qty": 0, "attr1": "", "attr2": "", "attr3": "", "attr4": "", "attr5": "", "attr6": "", "attr7": "", "attr8": "", "attr9": "", "attr10": "", "created_at": "05/15/23 01:17 PM", "updated_at": "05/22/23 11: 09 AM", "status": { "id": 1010, "name": "Live" }, "static_zone": "", "static_zone_last_update": "", } }
Error (Status Code: 401)
{ "status": "error", "message": "Invalid API key" }
Error (Status Code: 404)
{ "status": "error", "message": "The Item number is not valid" }
Update Asset
METHOD: PUT
URL: {tenant}/{location}/api/v1/assets/(id)
PARAMETERS:
api_key=xxxxxxxxxx
REQUEST BODY:
{ "item_number": "213000891211", "alt_serial": "MPZ", "current_units": 1.0, "storage_unit": 1.0, "adjust_qty": 0, "attr1": "S", "attr2": "E", "attr3": "N", "attr4": "I", "attr5": "T", "attr6": "R", "attr7": "O", "attr8": "N", "attr9": "C", "attr10": "O" }
RESPONSE BODY:
Success (Status Code: 200)
{ "message": "The asset updated succesfully", "asset": { "id": 342, "serial_number": "63402", "item_number": "213000891211", "alt_serial": "", "epc": "2938000000000000000003FE", "first_seen": "05/22/23 11:09 AM", "last_seen": "05/22/23 11:09 AM", "last_seen_antenna": "", "last_zone": "", "handheld_reader": "HH-471", "handheld_last_seen": "05/22/2023 11:09 AM", "current_units": 1.0, "storage_unit": 1.0, "adjust_qty": 0, "attr1": "S", "attr2": "E", "attr3": "N", "attr4": "I", "attr5": "T", "attr6": "R", "attr7": "O", "attr8": "N", "attr9": "C", "attr10": "O", "created_at": "05/15/23 01:17 PM", "updated_at": "06/22/23 10:20 AM", "status": { "id": 1010, "name": "Live" }, "static_zone": "", "static_zone_last_update": "", } }
Error (Status Code: 401)
{ "status": "error", "message": "Invalid API key" }
Error (Status Code: 404)
{ "status": "error", "message": "The asset ID is not valid" }
Delete Asset
METHOD: DELETE
URL: {location}/api/v1/assets/(id)
PARAMETERS:
api_key=xxxxxxxxxx
REQUEST BODY:
None
RESPONSE BODY:
Success (Status Code: 200)
{ "message": "The asset deleted (tag killed) succesfully" }
Error (Status Code: 401)
{ "status": "error", "message": "Invalid API key" }
Error (Status Code: 404)
{ "status": "error", "message": "The asset ID is not valid" }