如何通过Ballerina以SOAP请求调用NetSuite SuiteScript

1 前置准备 #

提前准备好你在Postman测试时已经验证可用的参数：

• NetSuite 账户ID
• OAuth 1.0 消费者密钥、消费者秘钥
• OAuth 1.0 访问令牌、令牌秘钥
• 已部署SuiteScript的SOAP访问端点URL
• 签名方法（和Postman测试时保持一致即可，推荐使用HMAC-SHA256）

2 配置项目依赖 #

在你的Ballerina项目的Ballerina.toml中添加以下依赖：

[[dependency]]
org = "ballerinax"
name = "oauth1"
version = "0.3.0" # 可替换为最新稳定版

[[dependency]]
org = "ballerina"
name = "soap"
version = "1.7.0" # 可替换为最新稳定版

3 编写集成代码 #

3.1 导入所需模块 #

import ballerina/log;
import ballerina/soap;
import ballerinax/oauth1;

3.2 配置OAuth1认证提供器 #

// 替换下方占位符为你的实际参数
oauth1:OAuth1Config oauthConfig = {
    consumerKey: "YOUR_CONSUMER_KEY",
    consumerSecret: "YOUR_CONSUMER_SECRET",
    accessToken: "YOUR_ACCESS_TOKEN",
    accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
    signatureMethod: oauth1:HMAC_SHA256,
    realm: "YOUR_NETSUITE_ACCOUNT_ID" // NetSuite的realm填写账户ID，需全大写
};

// 初始化OAuth1认证处理器
oauth1:ClientOAuth1Handler oauthHandler = check new (oauthConfig);

3.3 初始化SOAP客户端 #

// 绑定OAuth1认证处理器到SOAP客户端
soap:Client soapClient = check new ("YOUR_SUITESCRIPT_SOAP_ENDPOINT_URL", {
    auth: oauthHandler
});

3.4 构造并发送SOAP请求 #

// 下方为请求结构示例，需替换为符合你SuiteScript接口要求的实际请求内容
xml requestBody = xml `<ns0:getSavedSearchDataRequest xmlns:ns0="urn:your.suitescript.namespace">
    <ns0:searchId>YOUR_SAVED_SEARCH_ID</ns0:searchId>
    <ns0:pageSize>100</ns0:pageSize>
</ns0:getSavedSearchDataRequest>`;

// 发送SOAP请求
soap:SoapResponse response = check soapClient->sendReceive("getSavedSearchData", requestBody);

// 处理返回结果
xml responseXml = response.getContent();
log:printInfo("请求成功，返回数据：" + responseXml.toString());

4 注意事项 #

• 敏感认证参数不要硬编码在代码中，建议使用Ballerina的Config.toml配置文件存储，运行时动态读取
• 确保OAuth令牌对应的NetSuite角色拥有该SuiteScript部署的访问权限、SOAP API访问权限，以及对应Saved Search的查看权限
• 签名方法必须和Postman测试时使用的方法一致，避免认证失败
• 注意遵守NetSuite API的速率限制规则，避免触发限流
• 若请求失败，可打印完整请求头和响应内容，和Postman中正常请求的参数做对比排查问题

内容的提问来源于stack exchange，提问作者Buddhika Priyabhashana