cybozu.com 共通 API 文件

匯入使用者資訊

information

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

目錄

匯入使用者資訊

連結已複製

使用CSV檔匯入使用者資訊的差異。
有關要匯入的使用者資訊的CSV檔案格式，請參閱以下連結。

有關以JSON格式更新的API的詳細資訊，請參閱以下頁面：

URL

連結已複製

https://sample.cybozu.com/v1/csv/user.json

HTTP方法

連結已複製

POST

所需存取權限

連結已複製

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

請求

連結已複製

參數
參數名稱 類型 必須 說明
fileKey 字串 必須 從API取得的文件金鑰用於上傳CSV文件
上傳CSV檔案的API
variableCustomItemLength 布爾值 可省略 即使存在過多或缺少的個人資料項目值，是否也允許完成匯入
  • true：完成匯入
    • 如果個人資料項目對應的行數不足，則只會依序匯入已包含的項目值。
    • 如果個人資料項目對應的行不夠，沒有值的項目會保留原始資料
    • 如果對應個人資料項目的行太多，則會忽略多餘的行並匯入。
  • false：失敗
如果省略，則設置「false」。
示例請求
標頭

如果要使用API權杖，則需要權限範圍為「DangerousZone」的權杖。

1
2
3
4

{
  "Authorization": "Bearer API_TOKEN",
  "Content-Type": "application/json"
}

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

內文
1
2
3
4

{
  "fileKey": "c15b3870-7505-4ab6-9d8d-b9bdbc74f5d6",
  "variableCustomItemLength": true
}

回應

連結已複製

屬性
屬性名稱 類型 說明
id 數值 執行結果的ID
若要查看處理結果，請運行確認匯入結果API。
確認匯入結果API
示例回應
1
2
3

{
  "id": 1
}

示例代碼

連結已複製

使用curl的請求

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

1
2
3
4
5
6

curl -X POST 'https://sample.cybozu.com/v1/csv/user.json' \
  -H 'Authorization: Bearer API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
        "fileKey": "c15b3870-7505-4ab6-9d8d-b9bdbc74f5d6"
      }'