Segment API问题：添加成员至Segment后未在UI中显示

问题背景 #

已通过本地调用Banno Segment API成功创建Segment，且可在UI中验证其存在。随后使用CSV导入接口为该Segment添加成员，请求及响应如下：

请求命令 #

curl --request POST 'https://banno.com/a/segments/api/v0/institutions/1234/segments/eba9970a-7387-4dbb-844f-1212121212/import?sourceType=netteller_id&operationType=append' \
--header 'Content-Type: multipart/form-data' \
--header 'Accept: application/json' \
--form 'sourceProvider="Some Bank"' \
--form 'file=@"/Documents/segment_members.csv"' \
--header 'Authorization: Bearer <access_token>'

接口响应 #

{"csvHeaders":["netTellerId"],"csvUnknownRows":[],"draftId":"121212-ecc8-4a17-befb-0ddef9f8ce41","foundUsersCount":2,"operationCount":4}

接口返回成功响应，但在UI中查看该Segment时，成员数仍显示为0，未看到添加的成员。

排查建议 #

• 确认草稿是否提交：响应中的draftId表明本次导入仅生成了草稿，未直接生效。需通过对应API提交草稿，或在后台管理界面找到该草稿完成确认操作，成员才会被正式添加到Segment中
• 核对参数与数据映射：检查sourceType=netteller_id与CSV表头netTellerId的大小写/命名是否完全匹配，API参数为全小写，表头为驼峰式，可能存在映射不匹配导致有效用户未被关联
• 等待异步执行完成：部分Segment成员更新为异步任务，需等待1-5分钟后刷新UI查看结果
• 验证权限与资源ID：确认请求中的institutionId、segmentId完全正确，且请求使用的access_token拥有Segment成员管理的完整权限
• 查看操作日志：在后台系统的日志模块，通过draftId或segmentId搜索操作记录，确认是否有成员添加的执行日志或错误信息

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