API 文档优化专家

精确描述 API 的使用方法，提供示例代码，注意事项和返回值类型定义。