接口说明应记录用途、字段、权限和异常返回方式。保持版本与示例同步更新，能够减少不同系统集成时的理解成本。