请求参数按 role 表那样逐字段列出(字段/类型/必填/说明),对接方更易懂。
dictionary 标注为选填(schema 是 .optional(),不传换票仍成功,仅显示原始 id)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>