Netsuite REST API 基于TBA认证的查询实现方法（Python）

基于你已验证可用的TBA认证代码，直接调整请求路径与参数即可实现customrecord1589自定义记录的查询，两种查询场景的实现方式如下：

查询customrecord1589全表记录列表 #

构造GET请求，请求路径为/record/v1/customrecord1589，可搭配查询参数实现分页、过滤等需求：

• limit：单次请求返回的最大记录数，最高支持1000
• offset：分页偏移量，用于翻页拉取全量数据
• q：过滤条件，支持多条件拼接，示例：q=custrecord_custom_field eq "筛选值"
• fields：指定返回字段，减少数据传输量，示例：fields=id,name,custrecord_field1,custrecord_field2

Python请求示例（复用你已有的TBA签名、域名配置逻辑即可）：

import requests

# 以下参数均为你已有TBA代码中可直接复用的内容
NETSUITE_REST_BASE = "https://<你的账号标识>.restlets.api.netsuite.com"
auth_headers = 你的TBA认证生成的请求头

# 查询列表请求
list_resp = requests.get(
    url = f"{NETSUITE_REST_BASE}/record/v1/customrecord1589?limit=100&offset=0",
    headers = auth_headers
)
record_list = list_resp.json()

查询单条指定记录 #

已知目标记录的内部ID时，直接在路径后拼接记录ID即可，请求路径格式为/record/v1/customrecord1589/<目标记录内部ID>
Python请求示例：

import requests

# 复用已有配置
NETSUITE_REST_BASE = "https://<你的账号标识>.restlets.api.netsuite.com"
auth_headers = 你的TBA认证生成的请求头

# 替换为实际要查询的记录内部ID
target_record_id = 123
detail_resp = requests.get(
    url = f"{NETSUITE_REST_BASE}/record/v1/customrecord1589/{target_record_id}",
    headers = auth_headers
)
single_record = detail_resp.json()

注意事项 #

• 调用前确认你的接口使用的角色已开通customrecord1589的查看权限，否则会返回403无权限错误
• 全表数据量较大时，可通过返回结果中的totalResults字段判断总条数，循环调整offset参数拉取全量数据

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