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>