cybozu.com 共通 API 文件

新增組織

information

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

目錄

新增組織

連結已複製

新增組織。
您一次最多可以新增100個組織。

有關導入CSV檔的API的詳細內容，請參考以下頁面。
匯入組織資訊

URL

連結已複製

https://sample.cybozu.com/v1/organizations.json

HTTP 方法

連結已複製

POST

所需存取權限

連結已複製

cybozu.com共通管理員 (External link)

請求

連結已複製

參數

如果要同時新增具有父子結構的組織，請先指定父組織的資訊。

參數名稱 類型 必須 說明
organizations 陣列 必須 組織資訊清單
organizations[].code 字串 必須 組織代碼
指定不超過 128 個字元
不能指定空格或僅指定空格。
organizations[].name 字串 必須 組織名稱
指定不超過 128 個字元
不能指定空格或僅指定空格。
organizations[].localName 字串 可省略 其他語言下的顯示名稱
指定不超過 128 個字元
organizations[].localNameLocale 字串 可省略 其他語言下的顯示名稱（語言）
您可以指定以下值：
  • ja：日文
  • en：英語
  • zh： 中文（简体）
  • zh-TW： 中文（繁體）
  • es：西班牙文
如果省略，或者指定了空字串 或 null ，則設置系統的初始值系統的初始值。
系統的初始值 (External link)
organizations[].parentCode 字串 可省略 上級組織代碼
指定上級組織是否 null 為根組織。
organizations[].description 字串 可省略 說明
指定不超過 1,000 個字元
示例請求
標頭
1
2
3
4

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

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

內文
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

{
  "organizations": [
    {
      "code": "Sales03",
      "name": "北美銷售部",
      "localName": "North America Sales Department",
      "localNameLocale": "en",
      "description": "北美銷售部",
      "parentCode": "Sales00"
    }
  ]
}

回應

連結已複製

1

{}

示例代碼

連結已複製

使用 curl 的請求
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

curl -X POST 'https://sample.cybozu.com/v1/organizations.json' \
  -H 'X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU=' \
  -H 'Content-Type: application/json' \
  -d '{
        "organizations": [
          {
            "code": "Sales03",
            "name": "北美銷售部",
            "localName": "North America Sales Department",
            "localNameLocale": "en",
            "description": "北美銷售部",
            "parentCode": "Sales00"
          }
        ]
      }'

限制事項

連結已複製

  • 如果已在組織的預配置 中創建預留數據，則無法運行API。
  • 不建議在cybozu.com共通管理中執行以下操作並行執行 API：
    • 組織和用戶設置畫面上的組織操作
    • 從檔案匯入