My Items, Status Board and Requestable Devices API
Product: NEXTMEGABYTE (Greenitco ITAM) · Module: API Documentation · Audience: Developer, Administrator
This page lists the NEXTMEGABYTE REST API endpoints for self-service. All URLs are relative to your portal, for example https://your-domain.com/api/.... Authenticate first with the Login API and send the standard headers described in the API Overview. Example values are shortened and anonymized.
List my assigned items
POST /api/v2/user/jx-assigned-devices
Returns the devices and other items assigned to the signed-in user.
Headers: standard authenticated headers (apptoken, token, Content-Type: application/x-www-form-urlencoded). See API Overview.
Request Body Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | int | Yes | 590 |
| search_key | String | Yes | test |
| order_by | int | Yes | 2 |
| order_dir | int | Yes | 1 |
| asset_type | String | Yes | user |
| index | int | Yes | 1 |
Example request
{ "user_id": 590, "search_key": "test" "order_by": 1, "order_dir": 1 "asset_type": "test", "index": 1 }
Top-level response fields: status, msg, recordsTotal, recordsFiltered, current_index, is_prev_index, is_next_index, data
Example response (values shortened and anonymized)
{
"status": "success",
"msg": "",
"recordsTotal": 1,
"recordsFiltered": 1,
"current_index": 0,
"is_prev_index": 0,
"is_next_index": 0,
"data": [
{
"id": 348,
"asset_tag": "<string>",
"name": "test",
"mdl_name": "<string>",
"mnf_name": "<string>",
"serial": "<string>",
"model_id": 3,
"manufacturer_id": 29,
"project_name": "<string>",
"image": null,
"image_thumbnail": null,
"last_checkout_format": "12 Sep 2024",
"device_img": "<string>"
}
]
}
List requestable devices
POST /api/jx-requestable-device
Returns devices that users can request.
Headers: standard authenticated headers (apptoken, token, Content-Type: application/x-www-form-urlencoded). See API Overview.
Request Body Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| list_size | int | Yes | 20 |
| order_dir: | int | Yes | 1 |
| order_by | int | Yes | 1 |
| index:: | int | Yes | 0 |
Example request
{ "list_size": 20, "order_dir": 1 "order_by": 1, "index": 0 }
Top-level response fields: status, msg, tot, filter_record, current_index, is_prev_index, is_next_index, data
Example response (values shortened and anonymized)
{
"status": "success",
"msg": "",
"tot": 122,
"filter_record": 122,
"current_index": 0,
"is_prev_index": 0,
"is_next_index": 1,
"data": [
{
"id": 272,
"requested_id": null,
"asset_tag": "<string>",
"uuid": "<string>",
"mdl_name": "<string>",
"manu_name": "<string>",
"cmp_name": "<string>",
"loc_name": "<string>",
"name": "queen",
"serial": "<string>",
"last_checkout_on": null,
"lbl_name": "<string>",
"image": "<string>",
"image_thumbnail": null,
"device_img": "https://your-domain.com/..."
},
"..."
]
}
Request a device
GET /api/request-device/device_id
Sends a request for a requestable device.
Headers: standard authenticated headers (apptoken, token, Content-Type: application/x-www-form-urlencoded). See API Overview.
Example response (values shortened and anonymized)
{
"status": "success",
"section": "<string>",
"msg": "Device has requested successfully!"
}