java特殊api接口的文档和后端解析问题?

接口有一个类型字段,根据类型字段的值不同,所需的其他参数也不同。例:字段A的值为1,则还需要字段B和字段C;若A的值为2,则需要字段B和字段D。 要求:避开传递所有字段的情况(不使用的字段值为null)。要使调用方看的明白,接口文档如何写?最好还能给个后端解析的思路,目前思路是一个公共bean接收公共参数,再根据不同类型提供不同的扩展bean。

接口文档里A B C D字段都写上啊 A、B后注明必传 C后注明当A=1时必传 D后同理