cybozu.com共通管理API

匯入組織資訊

目錄

匯入組織資訊

使用 CSV 檔匯入組織資訊。
有關要導入的使用者資訊的 CSV 檔的格式,請參閱組織資訊 CSV。

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

URL

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

HTTP 方法

POST

所需存取權限

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

請求

參數
參數名稱 類型 必須 說明
fileKey 字串 必須 通知條件從API取得的文件Key用於上傳CSV文件
上傳CSV檔案的 API
示例請求
標頭

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

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

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

內文
1
2
3
{
  "fileKey": "c15b3870-7505-4ab6-9d8d-b9bdbc74f5d6"
}

回應

屬性
屬性名稱 類型 說明
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/organization.json' \
  -H 'Authorization: Bearer API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
        "fileKey": "c15b3870-7505-4ab6-9d8d-b9bdbc74f5d6"
      }'

注意事項

  • CSV 檔還應包含現有組織資訊。
    CSV 中不存在的組織代碼的組織將被刪除。
  • 刪除上層客戶時,下級單位也會被刪除。
    刪除組織時的注意事項 (External link)