如何使用ShareFile API創建「客戶端用戶」？

Question

使用ShareFile的API我想創建一個「客戶端用戶」，但現有的文檔不夠詳細，無法使任務直接進行。

請提供示例HTTP請求和響應，演示「創建客戶端用戶」端點的用法。

Answer 1

在發出請求之前，您需要確保關聯的帳戶已經建立，並且您已經獲得了oauth2標記。如果使用ShareFile帳戶登錄並訪問the documentation，則可以使用的oauth2標記將顯示在頁面的頂部。

從那裏你需要構建你的請求。下面是一些細節用星號絕密爲例請求，以保護無辜：

POST /sf/v3/Users HTTP/1.1 
Host: **********.sf-api.com 
Authorization: Bearer ********** 
Content-Type: application/json 
Cache-Control: no-cache 

{"Preferences": {"CanResetPassword": true, "CanViewMySettings": true}, "FirstName": "Billy", "LastName": "Bobby", "Company": "Bobby's World", "Password": "**********", "Email": "**********", "DefaultZone": {"Id": "**********"}} 

這裏是一個示例響應正文：

{ 
"Email": "************", 
"Username": "************", 
"TotalSharedFiles": 0, 
"Id": "************", 
"Contacted": 0, 
"FirstName": "Billy", 
"ReferredBy": "************", 
"IsConfirmed": false, 
"LastName": "Bobby", 
"Company": "Bobby's World", 
"FullNameShort": "B. Bobby", 
"DateCreated": "2017-02-13T22:19:07.92Z", 
"odata.metadata": "https://************.sf-api.com/sf/v3/$metadata#Users/ShareFile.Api.Models.User@Element", 
"url": "https://************.sf-api.com/sf/v3/Users(************)", 
"Domain": "************", 
"FullName": "Billy Bobby", 
"odata.type": "ShareFile.Api.Models.User", 
"Roles": 
    ["Client", "CanChangePassword", "CanManageMySettings"], 
"Emails": ["************"] 
} 

隨着響應身體會有一些頭根據你的情況，這可能是有用的。特別要注意Set-Cookie頭文件SFAPI_AuthID和SFAPI_SRVNAME。 According to the documentation這些值可以由您的客戶端保留，並用於緩解ShareFile API服務器上後續API調用的負載。