cybozu.com共通管理API

更新使用者的登入名

目錄

更新使用者的登入名

更新使用者的登入名。
一次最多只能選擇100個使用者。

有關導入CSV檔的API的詳細內容,請參考以下頁面。
匯入用戶資訊

URL

https://sample.cybozu.com/v1/users/codes.json

HTTP 方法

PUT

所需存取權限

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

請求

參數
參數名稱 類型 必須 說明
codes 陣列 必須 用戶登入名清單
codes[].currentCode 字串 必須 當前登入名
指定不超過128個字元
不能只指定空字串或空格。
codes[].newCode 字串 必須 更新了登入名
指定不超過128個字元
不能只指定空字串或空格。
示例請求
標頭

使用API權杖時,需要權限範圍為「Read and Write」或更高權限範圍的權杖。

1
2
3
4
{
  "Authorization": "Bearer API_TOKEN",
  "Content-Type": "application/json"
}

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

內文
1
2
3
4
5
6
7
8
{
  "codes": [
    {
      "currentCode": "sato-noboru",
      "newCode": "yamada-noboru"
    }
  ]
}

回應

1
{}

示例代碼

使用curl的請求

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

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
curl -X PUT 'https://sample.cybozu.com/v1/users/codes.json' \
  -H 'Authorization: Bearer API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "codes": [
      {
        "currentCode": "sato-noboru",
        "newCode": "yamada-noboru"
      }
    ]
  }'

限制事項

  • 不建議在cybozu.com共通管理中執行API的同時,執行以下操作。
    • 組織和使用者設置畫面上的使用者操作
    • 從檔案匯入