如何使用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调用的负载。