api:networkmanagement:devicetplink:lookup
Table of Contents
API : Network Device TP Link Lookup
Introduction
Looks up the MAC address for a given TP-Link serial number in the global imported-device catalogue. Returns the MAC address if a matching imported device exists, otherwise `null`.
Request
| URL | https://api.telecomx.dk/network/device/lookup-serial/{serialNumber} | ||
|---|---|---|---|
| Method | GET | ||
| Access level | VIEWER, MANAGER or OWNER - the user's own customer must have the NETWORK_MANAGEMENT feature. RESELLER_ADMIN and ADMIN may look up any serial without the feature. |
||
| Property | Type | Description | |
| Param | serialNumber | String | Serial number of the TP-Link device (11–13 characters). |
Query examples
https://api.telecomx.dk/network/device/lookup-serial/22TESTSN0001
Response
| Property | Type | Description |
|---|---|---|
| macAddress | String | MAC address of the device if found, otherwise null. |
Example
{ "macAddress": "00005E005301" }
Example (not found)
{ "macAddress": null }
Errors
| Error code | Message | Description |
|---|---|---|
| 403 | access_denied | The user's customer does not have the network management feature. |
| 422 | serialNumber | Serial number must be 11-13 characters. |
| 500 | internal_error | <Unspecified> |
api/networkmanagement/devicetplink/lookup.txt · Last modified: by Mikkel Meerwaldt Jørgensen