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调用。

如何使用ShareFile API创建“客户端用户”？

1 个答案: