Provision a new thing

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

Provision a new things

Authorization Action:

core:provision:things

Request

application/json

Bodyrequired

Provision thing request body

namestring
tenantstringrequired
modelstringrequired
init_idstringrequired

External identifier (MAC address or similar)

init_keystringrequired

External key

migration_keystring
migration_key_quotainteger<int32>

Responses

201

Provisioning response data.

application/json

Schema

Schema

things object[]
Array [
idstring
namestring
keystring
metadata object
property name*any
tenantstring
modelstring
]
channels object[]
Array [
idstring
namestring
metadata object
property name*any
tenantstring
]
client_cert object
property name*string
client_key object
property name*string
ca_certstring
ca_chainstring
whitelisted object
property name*boolean
errorstring

Example (auto)

{
  "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.

Authorization: http

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

• csharp
• curl
• dart
• go
• http
• java
• javascript
• kotlin
• c
• nodejs
• objective-c
• ocaml
• php
• powershell
• python
• r
• ruby
• rust
• shell
• swift

• HTTPCLIENT
• RESTSHARP

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://apis.<domain>/iot/provision/things");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("Authorization", "Bearer <token>");
var content = new StringContent("{\n  \"name\": \"string\",\n  \"tenant\": \"string\",\n  \"model\": \"string\",\n  \"init_id\": \"string\",\n  \"init_key\": \"string\",\n  \"migration_key\": \"string\",\n  \"migration_key_quota\": 0\n}", null, "application/json");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

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
}