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"
}