Table of Contents

API : Network Device Model Update

Introduction

This request will update a network device model. The picture is changed separately with Upload picture.

Request

URL https://api.telecomx.dk/network/device/model/MODEL_ID
Method POST
Access level RESELLER_ADMIN or ADMIN.
Params MODEL_ID Id of device model to update.
Property Type Description
Body brand String Name of brand: TP-LINK.
name String Name of device model - 2-100 characters.
type String Type of device: ROUTER, SWITCH, ACCESS_POINT, FIREWALL, MODEM, OTHER.
description String A short description of the device model and its capabilities - max 500 characters.
capabilities Subsection with device capabilities
capabilities.wifi Boolean True if the device model supports wifi.
capabilities.wifi2G Boolean True if the device model supports 2.4GHz wifi.
capabilities.wifi5G Boolean True if the device model supports 5GHz wifi.
capabilities.wifi6G Boolean True if the device model supports 6GHz wifi.
capabilities.simSupport Boolean Supports SIM-card. Only relevant if type = “ROUTER”.

Only changed properties needs to be included in the request.

Body example

{
  "brand": "TP-LINK",
  "name": "XVS-200"
}

Response

Property Type Description
_id Id Unique id of the device model.
brand String Name of brand: TP-LINK.
name String Name of device model.
type String Type of device: ROUTER, SWITCH, ACCESS_POINT, FIREWALL, MODEM, OTHER.
picture Id Id of picture of the device on image.telecomx.dk, 256×256 pixels or larger.
description String A short description of the device model and its capabilities.
capabilities Subsection with device capabilities
capabilities.wifi Boolean True if the device model supports wifi.
capabilities.wifi2G Boolean True if the device model supports 2.4GHz wifi.
capabilities.wifi5G Boolean True if the device model supports 5GHz wifi.
capabilities.wifi6G Boolean True if the device model supports 6GHz wifi.
capabilities.simSupport Boolean Supports SIM-card. Only relevant if type = “ROUTER”.

Note that properties holding no value may be omitted from the object.

Example

{
  "_id": "12345678901234567890ABCC",
  "brand": "TP-LINK",
  "name": "XVS-200",
  "type": "ROUTER",
  "picture": "12345678901234567890ABCD",
  "description": "5G router with 2,4/5Ghz wifi and ethernet.",
  "capabilities": {
    "wifi": true,
    "wifi2G": true,
    "wifi5G": true,
    "wifi6G": false,
    "simSupport": true
  }
}

Errors

Error code Message Description
403 access_denied Insufficient access level
404 not_found Network device model not found
422 <field> A field value is invalid.
500 internal_error <Unspecified>