关于Banno Segments API中draftId及创建接口请求体参数的咨询

关于draftId的说明 #

draftId是用于关联系统中已存在的Segment草稿的唯一标识符，不能传入随机UUID。这个ID必须从系统生成的草稿资源中获取：通常在调用创建Segment草稿的接口后，接口返回结果会包含该草稿的draftId；也可以通过查询Segment草稿列表的接口，找到目标草稿对应的ID值。当你需要基于一个已编辑完成的草稿来创建正式Segment时，才需要传入这个参数。

完整请求体参数解释 #

• name（字符串，必填）：要创建的Segment的名称，需具备标识性，清晰体现该Segment的用途或分类，方便后续管理与识别。
• sourceProvider（字符串，必填）：指定Segment数据的来源提供商，该值必须与系统中预先配置的合法提供商名称一致，用于标记Segment数据的来源渠道。
• draftId（字符串，可选）：关联已存在的Segment草稿的ID，仅当基于草稿创建正式Segment时需要传入。必须使用系统生成的有效草稿ID，不能自定义或使用随机UUID，获取途径为创建草稿接口的返回结果或草稿列表查询接口。

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