RTMP 配信を始める

カメラの映像を YouTube Live などの RTMP サーバーへ配信します。配信先はカメラ 1 台につき 1 つで、既に設定があれば置き換えます。エッジPC へ指示を送った時点で返るので、実際に配信が始まったかはデバイスの詳細の streaming.active で確かめてください。スコープは data:write が要ります。

POST/devices/{id}/streaming

Authorization

AuthorizationBearer token · headerrequired

組織設定の「API・MCP」タブで発行した API トークン（tcn_ で始まる）。

Path parameters

idstringrequired

デバイス ID（<エッジPC の Thing 名>__<UUID>）

Request body

requiredapplication/json

rtmpUrlstring<uri>required

RTMP サーバーの URL（rtmp:// か rtmps://）

streamKeystringrequired

ストリームキー。応答には含めません

min length 1

resolutionstring

配信の解像度（既定 720p）

Allowed:480p720p1080p

Responses

200

成功

okbooleanrequired

400

入力の検証エラー、または対象の種類が合わない

errorstringrequired

人が読めるエラーメッセージ

401

トークンが無い、または無効

errorstringrequired

人が読めるエラーメッセージ

403

スコープが足りない、または操作が許可されていない

errorstringrequired

人が読めるエラーメッセージ

404

対象が無い（他の組織のものを含む）

errorstringrequired

人が読めるエラーメッセージ

409

今の状態ではできない操作

errorstringrequired

人が読めるエラーメッセージ

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer tokenRemember on this deviceInclude my values in samples

Parameters

idpath*デバイス ID（`<エッジPC の Thing 名>__<UUID>`）

Bodyapplication/json

rtmpUrlstring*RTMP サーバーの URL（`rtmp://` か `rtmps://`）streamKeystring*ストリームキー。応答には含めませんresolutionstring配信の解像度（既定 720p）

Request

curl -X POST 'https://api.thingsconnect.app/api/v1/devices/string/streaming' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "rtmpUrl": "rtmp://a.rtmp.youtube.com/live2",
  "streamKey": "xxxx-xxxx-xxxx-xxxx",
  "resolution": "720p"
}'

const response = await fetch("https://api.thingsconnect.app/api/v1/devices/string/streaming", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"rtmpUrl\": \"rtmp://a.rtmp.youtube.com/live2\",\n  \"streamKey\": \"xxxx-xxxx-xxxx-xxxx\",\n  \"resolution\": \"720p\"\n}"
});

import requests

response = requests.post(
    "https://api.thingsconnect.app/api/v1/devices/string/streaming",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"rtmpUrl\": \"rtmp://a.rtmp.youtube.com/live2\",\n  \"streamKey\": \"xxxx-xxxx-xxxx-xxxx\",\n  \"resolution\": \"720p\"\n}",
)

Response

{
  "ok": true
}

{
  "error": "string"
}

{
  "error": "Unauthorized"
}

{
  "error": "data スコープが必要です"
}

{
  "error": "string"
}

{
  "error": "string"
}