kintone API文件

建立空間的主題

information

本頁面使用機器翻譯而成。
機器翻譯免責聲明 (External link)

目錄

建立空間的主題

連結已複製

建立空間的主題

  • 只能在空間設置中啟用了「使用空間門戶和多個主題」的空間中創建主題。
  • 主題創建通知將作為「全部」通知通知發送給空間的所有成員。
  • 如果不使用空間功能，則會發生錯誤。
  • 如果禁用了訪客空間功能，則在嘗試創建訪客空間時將發生錯誤。

URL

連結已複製

正常空間
https://sample.cybozu.com/k/v1/space/thread.json
訪客空間
https://sample.cybozu.com/k/guest/GUEST_SPACE_ID/v1/space/thread.json

HTTP 方法

連結已複製

POST

所需存取權限

連結已複製

  • 查看空間的許可權
    在非公開空間/訪客空間的情況下，只有空間參加者才能這樣做。

請求

連結已複製

參數
參數名稱 類型 必須 說明
space 數值或字串 必須 空間ID
name 字串 必須 主題名稱
您可以指定 1 到 128 個字元。
示例請求
標頭
1
2
3
4

{
  "X-Cybozu-Authorization": "QWRtaW5pc3RyYXRvcjpjeWJvenU=",
  "Content-Type": "application/json"
}

有關請求頭的更多資訊，請參閱以下頁面。
kintone REST API通用規範

正文
1
2
3
4

{
  "space": 1,
  "name": "樣本主題"
}

回應

連結已複製

屬性
屬性名稱 類型 說明
id 字串 創建的主題的ID
示例回應
1
2
3

{
  "id": "2"
}

示例代碼

連結已複製

使用 curl 的請求

根據您的環境，curl 的格式可能會有所不同。
有關說明，請參閱以下頁面。
使用curl命令執行kintone REST API/3.執行API 

1
2
3
4
5
6
7

curl -X POST 'https://sample.cybozu.com/k/v1/space/thread.json' \
  -H 'X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU=' \
  -H 'Content-Type: application/json' \
  -d '{
    "space": 1,
    "name": "樣本主題"
  }'
使用kintone.api()發送請求

有關詳細的kintone.api()，請參閱以下頁面。
發送kintone REST API請求 

1
2
3
4
5

const body = {
  space: 1,
  name: '樣本主題'
};
await kintone.api(kintone.api.url('/k/v1/space/thread.json', true), 'POST', body);