API : Network Device TP Link Upload

Introduction

This request takes a file (CSV) and creates a short form of network devices to make creation of devices easier.

Request

URL	https://api.telecomx.dk/network/device/import/csv
Method	POST
Access level	MANAGER or OWNER if user belongs to the customer. RESELLER if customer belongs to the reseller or a sub reseller. ADMIN.
	Property	Type	Description
Body	devices	Array<Object>	Array of devices to import
	devices[].serialNumber	String	Serial number of the device
	devices[].macAddress	String	MAC address of the device

Query examples

{
  "devices": [
    {
      "serialNumber": "224A3N700254",
      "macAddress": "306893508632"
    },
    {
      "serialNumber": "224A3N700253",
      "macAddress": "306893508631"
    }
  ]
}

Response

Property	Type	Description
inserted	Number	Number of devices successfully imported.
skipped	Number	Number of devices that were not imported (duplicates or failed inserts).
duplicates	Array<String>	List of messages describing each skipped device (duplicate or insert failure).

Example

{
  inserted: 3,
  skipped: 2,
  duplicates: [
    "Device with serial 224A3N700254 or MAC 306893508632 already exists",
    "Failed to insert device 224A3N700255"
  ]
}

Errors

Error code	Message	Description
403	AccessDenied	User does not have write access to the customer.
422	InvalidData	Request body is invalid (e.g. devices array, serialNumber or macAddress fails validation).
500	InternalError	Unexpected server error while processing the import or validating the response.

WIKI

Table of Contents

API : Network Device TP Link Upload

Introduction

Request

Query examples

Response

Example

Errors