Provision a new thing

POST 
https://apis.<domain>/iot/provision/things

Authorization: http

name: bearerAuthtype: httpscheme: bearerdescription: * Users access: "Authorization: Bearer <user_token>"

Provision a new things

Authorization Action:

core:provision:things

Request

application/json

Body

required

Provision thing request body

name string
tenant stringrequired
model stringrequired
init_id stringrequired

External identifier (MAC address or similar)

init_key stringrequired

External key

migration_key string
migration_key_quota int32

Responses

201

Provisioning response data.

application/json

Schema

Schema

things object[]
Array [
id string
name string
key string
metadata object
property name* any
tenant string
model string
]
channels object[]
Array [
id string
name string
metadata object
property name* any
tenant string
]
client_cert object
property name* string
client_key object
property name* string
ca_cert string
ca_chain string
whitelisted object
property name* boolean
error string

Example (from schema)

{
  "things": [
    {
      "id": "string",
      "name": "string",
      "key": "string",
      "metadata": {},
      "tenant": "string",
      "model": "string"
    }
  ],
  "channels": [
    {
      "id": "string",
      "name": "string",
      "metadata": {},
      "tenant": "string"
    }
  ],
  "client_cert": {},
  "client_key": {},
  "ca_cert": "string",
  "ca_chain": "string",
  "whitelisted": {},
  "error": "string"
}

400

Failed due to malformed JSON.

401

Missing or invalid access token provided.

500

Unexpected server-side error occurred.

• curl
• python
• go
• nodejs
• ruby
• csharp
• php
• java
• powershell

• CURL

curl -L -X POST 'https://apis.<domain>/iot/provision/things' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
  "name": "string",
  "tenant": "string",
  "model": "string",
  "init_id": "string",
  "init_key": "string",
  "migration_key": "string",
  "migration_key_quota": 0
}'

Request Collapse all

Base URL

https://apis.<domain>

Auth

Bearer Token

Body required

{
  "name": "string",
  "tenant": "string",
  "model": "string",
  "init_id": "string",
  "init_key": "string",
  "migration_key": "string",
  "migration_key_quota": 0
}