Register connection-tokens

Prev Next
Post
/inventory/thingConnectionTokens/import

Registers the connection-tokens used by the Things to communicate with the cloud.

Required permissions: READ_THING_CONNECTION_TOKENS, WRITE_THING_CONNECTION_TOKENS.

Security
HTTP
Type bearer
Header parameters
X-Servitly-Tenant
stringRequired

The name of the target tenant (e.g. acme).

Body parameters

The information of the connection-tokens being registered.

object
file
string (binary)

The CSV file with the list of connection-tokens to register having these columns:
- SEMIOTY_THING_CONNECTOR) token, username, password, asset-id, path [optional],
- EDC) token, accountName, username, password, asset-id, path [optional].

connectionMappingType
string

The type of the mapping associated to each connection-token.

Valid values[ "SEMIOTY_THING_CONNECTOR", "EDC" ]
description
string

The note text associated with the connection-tokens (e.g. PRODUCTION-20190601).

payloadFormat
string

The payload format of the messages exchanged with the cloud.

Valid values[ "JSON", "ASCII", "BINARY" ]
Responses
200

Successful registered.

object
id
string

The activated Thing identifier.

locationId
string

The identifier of the parent location.

serialNumber
string

The serial-number of the activated Thing.

connectionToken
string

The activated connection token.

400

Request data not valid.

object
message
string

The error response.

ExampleBad request
401

User not authenticated.

object
message
string

The error response.

ExampleUser not authenticated
403

User not authorized.

object
message
string

The error response.

ExampleUser not authorized
409

The location-id, serial-number or connection-token may be wrong.

429

API call rate limit exeeded.

object
message
string

The error response.

ExampleAPI call rate limit exeeded
500

Internal server error.

object
message
string

The error response.

ExampleInternal Server Error