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

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