SuiteCloud（SuiteTalk REST Web Services）现在通常适用于所有NetSuite产品，扩展了一组强大的补充SuiteTalk SOAP Web Services，这些Web Services已经成为NetSuite核心集成解决方案的一部分，已经有几个版本发布了。在SuiteTalk中包括REST Web Services为管理员和开发人员提供了更多集成NetSuite与环境、外部应用程序和数据源的选项。
REST Web Services支持API可发现性，提供基于链接的导航，为用户提供无缝访问NetSuite记录元数据，并为用户提供与自定义和标准记录交互的统一方法。
与用于构建基于REST的集成的服务器端RESTlets相比，无需编写服务器端代码或管理自定义代码。
此博客展示了如何在您的NetSuite帐户中使用OAuth 2.0构建基于REST的集成，以及Postman环境设置和POST请求。
要使用REST Web Services，必须在您的NetSuite账户中启用相关功能
- 转到“设置”>“公司”，单击“启用功能”。
- 选择“SuiteCloud”子选项卡。
- 在“SuiteTalk（Web Services）”部分中，勾选“REST Web Services”功能。
- 在“身份验证管理”部分中，勾选“OAuth 2.0”复选框。
- 在“分析”子选项卡中勾选“SuiteAnalytics Workbook”。
- 单击“保存”按钮。
分配所需权限给用户角色
- 转到“设置”>“用户/角色”>“管理角色”。
- 找到要修改的角色。单击“编辑”或“自定义”链接。
- 在“权限”子选项卡中，单击“设置”。
- 在权限列表中，从下拉列表中选择“REST Web Services”。
- 在“级别”列表中，选择“完全”。单击“添加”。
- 在设置下的权限列表中，从下拉列表中选择“使用访问令牌登录”。
- 在“级别”列表中，选择“完全”。单击“添加”。
- 单击“保存”。.
创建使用OAuth 2.0的应用程序的集成记录的步骤如下：
- 转到“设置”>“集成”>“集成管理”>“管理集成”，单击“新建”。
- 在必填的“名称”字段中为您的应用程序输入一个名称。
- 如果需要，在“描述”字段中输入描述。
- 在“状态”字段中选择“启用”。
- 如果需要，在“注释”字段中输入注释。
- 在“身份验证”选项卡上，为您的应用程序勾选适当的复选框。
- 勾选“Rest Web Services & RESTlets”复选框。
- 输入您的应用程序的有效重定向URI，授权码将在其中处理。对于演示，我将使用 https://netsuiteful.com。
- 在OAuth 2.0下，勾选“授权码授权”以使OAuth 2.0工作。
- 单击“保存”。
一旦单击保存按钮，客户端凭据值将显示在页面上。
注意：出于安全原因，这只会显示一次；确保您记下它们。
NetSuite提供一个特定于账户的域，包含NetSuite账户ID作为域名的一部分，以访问REST Web Services或RESTlets。您可以在“设置”>“公司”>“公司信息”下的“公司URL”子选项卡中找到公司的URL。
设置Postman环境：
Postman环境是您可以在Postman请求中使用的一组变量。使用Postman环境，您可以在各种NetSuite帐户之间切换，以及在测试或生产帐户之间切换。使用Postman环境，您可以使用变量自定义请求，以便在不更改请求的情况下切换不同的设置。
- 单击Postman应用程序顶部菜单中的图标。
- 弹出窗口将打开。在管理环境窗口上单击“添加”。
- 为您的环境输入一个自我描述的名称。
- 输入您的账户ID（例如，3604360）。
- 输入您创建的凭据，即consumer key/client id和consumer secret/client secret的值。
- 添加所有变量和值，如上所述。
- 单击“添加”。
创建Postman集合：
您可以通过单击左侧边栏中的“+ New”按钮、New>单击显示的Collection 选项来创建新的集合。将弹出一个新窗口。
- 为您的新集合命名。
- 在授权部分下选择OAuth 2.0类型。
- 如果没有自动添加以下详细信息，请按照以下步骤执行：
- 在Configure new token下：
- 输入Self- descriptive Token Name。
- 输入Auth URL：{{proto}}://{{account}}.app.{{nsdomain}}/app/login/oauth2/authorize.nl。
- 输入Access Token URL：{{proto}}://{{account}}.{{suitetalkapi}}.{{nsdomain}}/{{restservice}}/auth/oauth2/{{version}}/token。
- 输入作用域（REST Web Services输入rest_webservices，RESTlets输入restlets）。
- 单击GET New Access Token。
- 登录到您的NetSuite账户，单击“继续”按钮。
- 在弹出窗口的“管理访问令牌”窗口上单击“使用令牌”按钮。
- 令牌将自动添加到当前令牌下。
- 单击“创建”。
RESTlet POST请求：
创建新集合后，单击“添加请求”以创建第一个请求
{{proto}}://{{account}}.{{restletsapi}}.{{nsdomain}}/app/site/hosting/restlet.nl?script=<>&deploy=<>
- 添加RESTlet URL并输入测试正文。
- 单击Send。
- 成功响应将返回200 OK。
- 我们具有正确的状态，创建了一条记录，并在响应中找到了记录ID。这意味着我们可以进入NetSuite并通过第三方应用程序访问我们的帐户信息。因此，我们已经通过OAuth 2.0进行了授权。
总结和必要的步骤是：
- REST Web Services的先决条件和设置。
- 为用户角色分配所需权限。
- 创建集成记录，获取客户端ID和客户端密钥。
- 从公司信息中获取REST URL。
- 设置Postman环境和集合。
- 添加请求并测试集成。
Comments