攻克API文档：速成指南，让开发事半功倍！

2025-03-05 16:47:10 100

API文档详解

应用程序编程接口 (API) 文档是软件开发人员理解、集成和有效利用特定 API 的关键资源。 良好的 API 文档对于 API 的广泛采用、持续维护和长期成功至关重要，它能够显著降低学习曲线，使新手开发者能够快速上手；加速开发流程，提高开发效率并减少重复劳动；并且能够最大限度地减少集成过程中的错误，避免不必要的调试和返工。一份全面、清晰且易于理解的 API 文档不仅能节省开发人员的时间，还能提升他们的开发体验，最终促进 API 生态系统的健康发展。本文将深入探讨 API 文档的关键组成部分，包括但不限于认证授权、请求参数、响应结构、错误代码以及示例代码，同时还将探讨如何解读和利用这些关键信息，以便开发人员能够充分利用 API 的功能。

API 文档的结构

一个完整的 API 文档是开发者理解和成功集成 API 的关键。它应结构清晰、内容详尽，并提供必要的示例和支持信息。通常包含以下几个关键部分：

  • 概述（Overview）： 对 API 的总体描述，包括其核心目的、关键功能、目标受众（例如，开发者、数据分析师等）以及适用场景。概述部分应该简洁明了、引人入胜，能够让开发者在最短时间内快速了解 API 的主要用途和价值，并判断其是否满足自身需求。还可以简要提及 API 的技术架构和底层原理。
  • 身份验证（Authentication）： 详细描述如何对 API 请求进行身份验证，以确保安全性和防止滥用。这通常涉及到多种身份验证机制，如 API 密钥（API Key）、OAuth 2.0 授权框架、JWT (JSON Web Tokens)、多因素认证（MFA）等。文档应该清晰地说明如何获取和管理身份验证凭证（例如，如何注册应用以获取 API 密钥），以及如何在请求头或请求参数中正确地使用这些凭证。同时，解释不同身份验证机制的优缺点和适用场景，例如 OAuth 2.0 适用于第三方应用授权，而 API 密钥则适用于内部或受信任的应用。
  • 端点（Endpoints）： 以结构化的方式列出 API 提供的所有可用端点，以及每个端点的用途。每个端点条目通常包含以下信息：HTTP 方法（GET、POST、PUT、DELETE、PATCH 等）、URI 路径（包括路径参数）、参数说明（查询参数、路径参数和请求头）、请求体示例（如果需要）以及响应示例。对于每个端点，应详细描述其功能、输入参数、输出结果以及可能出现的错误情况。例如，对于一个获取用户信息的端点，应说明其 HTTP 方法为 GET，URI 路径为 /users/{user_id} ，参数包括 user_id （路径参数，必需），响应包括用户 ID、姓名、邮箱等字段。
  • 请求参数（Request Parameters）： 详细说明每个端点接受的请求参数，包括查询参数、路径参数和请求头。参数说明应包括参数名称、数据类型（例如，字符串、整数、布尔值、数组）、是否必需、默认值（如果适用）、可能的取值范围或枚举值、以及参数的含义和作用。对于复杂参数，应提供详细的结构说明和示例。例如，对于一个分页查询端点，应说明 page 和 page_size 参数的数据类型为整数， page 的默认值为 1， page_size 的取值范围为 1 到 100。
  • 请求体（Request Body）： 如果 API 端点接受请求体（例如，使用 POST、PUT 或 PATCH 方法发送 JSON、XML 或其他格式的数据），则文档应详细说明请求体的结构和格式。对于 JSON 请求体，可以使用 JSON Schema 来定义其结构。文档应清晰地描述每个字段的名称、数据类型、是否必需、默认值（如果适用）、可能的取值范围或枚举值、以及字段的含义和作用。还应提供请求体的示例，以便开发者能够正确地构造请求。
  • 响应（Response）： 描述 API 端点返回的响应，包括成功的响应和错误的响应。这通常包括 HTTP 状态码、响应头以及响应体的结构和格式。文档应该提供不同 HTTP 状态码的含义和示例（例如，200 OK 表示成功，400 Bad Request 表示请求错误，500 Internal Server Error 表示服务器内部错误），以及响应体中每个字段的说明。对于 JSON 响应体，可以使用 JSON Schema 来定义其结构。还应提供响应的示例，以便开发者能够正确地解析响应。
  • 错误码（Error Codes）： 列出 API 可能返回的所有错误码，以及每个错误码的含义、可能的出现原因和建议的解决方案。错误码应该具有清晰的命名规范，并且应该被组织成逻辑分组。例如，可以定义客户端错误（4xx）和服务端错误（5xx）等分组。对于每个错误码，应提供详细的描述，包括错误的原因、可能导致错误的输入、以及开发者应该采取的措施来解决错误。例如，对于 "INVALID_API_KEY" 错误码，应说明其含义为 API 密钥无效，原因是 API 密钥未激活或已过期，建议开发者检查 API 密钥的有效性并重新激活。
  • 示例代码（Code Examples）： 提供使用不同编程语言（例如 Python、Java、JavaScript、Go、PHP 等）调用 API 端点的示例代码。示例代码应该尽可能完整和可执行，包括身份验证、请求构造、响应解析和错误处理等步骤。示例代码应涵盖常见的用例，并提供多种编程语言的示例，以便开发者能够快速上手。还可以提供使用不同 HTTP 客户端库（例如 requests、axios、okhttp）的示例。
  • 速率限制（Rate Limiting）： 描述 API 的速率限制策略，即在特定时间内允许的请求数量。速率限制是为了保护 API 服务免受滥用和恶意攻击。文档应明确说明速率限制的阈值（例如，每分钟 100 次请求），以及超过速率限制后将返回的错误码（例如，429 Too Many Requests）。还应说明如何查询剩余的请求配额（例如，通过响应头），以及如何处理速率限制错误（例如，使用指数退避算法进行重试）。
  • 版本控制（Versioning）： 描述 API 的版本控制策略，以及如何指定要使用的 API 版本。版本控制是为了在 API 进行更新和修改时，保持向后兼容性，并允许开发者逐步迁移到新版本。文档应说明 API 的版本号格式（例如，v1、v2、v1.0、v1.1），以及如何指定 API 版本（例如，通过 URI 路径、请求头或查询参数）。还应说明不同版本之间的差异，以及迁移到新版本的建议步骤。
  • 术语表（Glossary）： 定义 API 文档中使用的专业术语，例如“端点”、“资源”、“请求”、“响应”、“身份验证”、“授权”等。术语表可以帮助开发者更好地理解 API 文档，并避免歧义。
  • 变更日志（Changelog）： 记录 API 的更新和修改历史，包括新增功能、修复 bug、性能优化、版本升级等。变更日志可以帮助开发者了解 API 的最新变化，并及时调整其代码。变更日志应按照时间顺序排列，并提供每个变更的详细描述。

如何解读 API 文档

  1. 阅读概述： 详细阅读 API 的概述部分。这部分通常会介绍 API 的核心功能、设计目标、适用场景以及与其他系统的集成方式。理解概述能帮助你快速判断 API 是否符合你的需求，并为后续深入学习打下基础。注意查找任何关于 API 设计哲学、最佳实践或已知限制的说明。
  2. 理解身份验证： 仔细阅读身份验证部分，理解 API 如何验证用户的身份。常见的身份验证方式包括 API 密钥、OAuth 2.0、JWT（JSON Web Tokens）等。务必了解如何获取、存储和使用这些凭证，以及如何处理凭证的过期和刷新。注意不同身份验证方式的安全性和适用场景。
  3. 浏览端点： 浏览 API 提供的所有端点，了解每个端点的功能和作用。端点是 API 中可访问的具体资源或服务，例如获取用户信息、创建订单等。仔细阅读每个端点的描述，并记录下你感兴趣的端点。可以使用 API 文档提供的搜索或过滤功能来快速找到所需的端点。
  4. 查看请求参数： 仔细查看每个端点的请求参数，了解哪些参数是必需的，哪些是可选的。参数的格式和取值范围对于正确调用 API 至关重要。一些参数可能需要特定的数据类型，如整数、字符串或布尔值。了解参数的含义和约束，以避免因参数错误导致 API 调用失败。
  5. 了解请求体： 如果端点需要请求体，仔细阅读请求体的结构和格式说明。请求体通常使用 JSON 或 XML 格式，用于传递复杂的数据结构。了解请求体的每个字段的含义、数据类型和约束，确保发送的数据符合 API 的要求。可以使用 API 文档提供的示例请求体作为参考。
  6. 研究响应： 了解 API 端点返回的响应，包括 HTTP 状态码、响应头以及响应体的结构和格式。HTTP 状态码表示 API 调用的结果，例如 200 表示成功，400 表示客户端错误，500 表示服务器错误。响应头包含关于响应的附加信息，例如内容类型和长度。响应体包含 API 返回的数据，通常使用 JSON 或 XML 格式。仔细研究响应体的每个字段的含义和数据类型，以便正确解析和处理 API 返回的数据。
  7. 注意错误码： 研究 API 可能返回的错误码，以便在出现问题时能够快速诊断和解决。错误码通常用于指示 API 调用失败的原因，例如参数错误、权限不足或资源不存在。了解每个错误码的含义和可能的解决方案，可以帮助你快速定位和修复问题。API 文档通常会提供错误码的列表和详细描述。
  8. 参考示例代码： 参考 API 文档提供的示例代码，了解如何使用不同的编程语言调用 API 端点。示例代码可以帮助你快速上手，并避免一些常见的错误。可以复制和修改示例代码，以满足你的特定需求。注意示例代码可能需要根据你的实际情况进行调整，例如修改 API 密钥或请求参数。
  9. 注意速率限制： 了解 API 的速率限制策略，避免超出限制。速率限制用于防止滥用 API，并确保 API 的稳定性和可用性。速率限制通常以每分钟或每小时允许的请求数来表示。超出速率限制可能会导致 API 调用失败。了解 API 的速率限制策略，并采取相应的措施，例如使用缓存或队列来减少 API 调用次数。
  10. 查看版本控制： 了解 API 的版本控制策略，并指定要使用的 API 版本。API 的版本控制允许 API 提供者在不破坏现有客户端的情况下引入新的功能或修改现有的功能。选择合适的 API 版本可以确保你的应用程序与 API 的兼容性。API 文档通常会提供 API 版本的列表和详细描述。在 API 调用中指定 API 版本，以确保使用正确的 API 版本。

特定加密货币API文档案例解析

以某个交易所提供的交易API为例，我们来看一下具体的文档结构及内容。交易所通常会提供详细的API文档，指导开发者如何通过编程方式与其平台交互。文档内容涵盖了身份验证、数据获取、交易执行、账户管理等多个方面。

身份验证： API访问的第一步通常是身份验证。文档会详细说明如何生成API密钥，以及如何使用密钥对请求进行签名。常见的身份验证方式包括HMAC（Hash-based Message Authentication Code）签名，开发者需要使用私钥对请求参数进行哈希运算，并将签名添加到请求头或查询参数中。文档还会明确密钥的权限范围，例如只读权限、交易权限等。

数据获取： API提供了获取市场数据的接口，包括实时价格、历史价格、交易深度、交易量等。文档会列出每个数据接口的URL、请求参数、响应格式。例如，获取特定交易对的实时价格，可能需要指定交易对的代码（如BTCUSDT），文档会说明如何正确构造请求，以及如何解析返回的JSON数据。

交易执行： 交易API允许开发者进行买入、卖出等交易操作。文档会详细说明各种订单类型的参数，例如市价单、限价单、止损单等。对于限价单，文档会说明如何指定价格和数量；对于止损单，文档会说明如何设置触发价格。文档还会描述如何处理订单提交失败的情况，例如资金不足、价格波动过大等。

账户管理： 账户管理API允许开发者查询账户余额、交易历史、提币记录等。文档会说明如何获取不同币种的可用余额、冻结余额。文档还会描述如何提交提币请求，以及如何查询提币状态。为了安全起见，提币API通常需要进行额外的身份验证，例如双重验证（2FA）。

除了接口说明，API文档还会包含以下重要信息：

  • 错误代码： API调用失败时，会返回特定的错误代码。文档会详细解释每个错误代码的含义，并提供相应的解决方案。
  • 速率限制： 为了防止API被滥用，交易所通常会设置速率限制。文档会说明每个接口的调用频率限制，以及如何处理超过速率限制的情况。
  • 代码示例： 为了方便开发者使用，API文档通常会提供各种编程语言的代码示例，例如Python、Java、JavaScript等。
  • 版本控制： 交易所可能会定期升级API，文档会明确API的版本号，以及不同版本之间的差异。

开发者在使用API时，应仔细阅读文档，并严格遵守文档中的规定，以确保API调用的正确性和安全性。

1. 概述

该应用程序编程接口（API）提供实时的、全面的加密货币交易数据，涵盖从价格到交易量的各种关键指标，并深入到订单簿的细节。这意味着用户可以访问最新的市场信息，以便做出明智的交易决策。API的核心功能在于允许用户执行加密货币的买卖交易，同时提供查询账户余额、交易历史等详细信息的手段，并支持订单管理功能，包括创建、修改和取消订单。API的设计目标是服务于广泛的用户群体，包括追求便捷交易的个人交易者，寻求高级数据分析的机构投资者，以及依赖自动化策略的量化交易团队。通过该API，用户可以高效地接入加密货币市场，并根据自身需求进行定制化开发和应用。

2. 身份验证

在加密货币交易所API交互中，身份验证是确保安全性的关键环节。本交易所采用API Key和Secret Key进行双重身份验证，旨在保护用户的账户安全和交易数据的完整性。

用户首先需要在其交易所账户中生成API Key和Secret Key。API Key相当于用户的公开身份标识，用于识别请求的来源。Secret Key则是用户的私密密钥，必须妥善保管，切勿泄露给任何第三方。Secret Key用于对API请求进行签名，以证明请求的真实性和完整性。

所有需要身份验证的API请求，都需要使用API Key和Secret Key进行签名。签名算法通常涉及将请求参数、API Key、时间戳等信息按照特定规则进行组合，然后使用Secret Key进行哈希运算（例如HMAC-SHA256）。签名后的字符串会作为请求头或请求参数的一部分发送给交易所服务器。

交易所服务器收到请求后，会使用API Key查找对应的Secret Key，并使用相同的签名算法对请求进行验证。如果验证成功，则认为请求是合法的，否则会拒绝请求。详细的签名算法和步骤将在API文档中详细描述，包括具体的参数顺序、数据类型、哈希算法以及示例代码，开发者务必仔细阅读并严格按照文档说明进行操作，以确保请求能够成功通过验证。

为了提高安全性，建议用户定期更换API Key和Secret Key，并启用IP白名单功能，限制API请求的来源IP地址。同时，应密切关注交易所发布的API安全公告，及时更新SDK和相关代码，以应对潜在的安全风险。

3. 端点示例

  • /api/v1/ticker : 获取所有交易对的最新价格。此端点提供快速访问市场行情数据的入口，允许用户实时监控各个交易对的价格变动，例如BTC/USDT、ETH/BTC等。返回的数据通常包括交易对名称、最新成交价、24小时最高价、24小时最低价、24小时成交量等关键信息，对于高频交易者和市场分析师至关重要。
  • /api/v1/depth : 获取指定交易对的订单簿。订单簿是市场供需关系的直观展现，包含了买单（bid）和卖单（ask）的价格和数量信息。通过此端点，用户可以了解特定交易对的买卖盘分布情况，评估市场深度和流动性。返回的数据通常包括多个层级的买单和卖单，按照价格排序，越靠近中间价的订单深度越深，对价格的影响也越大。分析订单簿可以帮助用户判断市场的支撑位和阻力位，制定更有效的交易策略。
  • /api/v1/orders : 查询用户的所有订单。此端点允许用户检索其在交易所中的所有订单记录，包括挂单、已成交订单、已取消订单等。通过此端点，用户可以追踪订单的状态，监控交易执行情况。通常需要用户身份验证，例如通过API密钥和签名进行授权。返回的数据通常包括订单ID、交易对、订单类型（限价单、市价单等）、订单方向（买入、卖出）、下单价格、下单数量、订单状态等详细信息。
  • /api/v1/order : 创建一个新的订单。此端点允许用户向交易所提交新的交易订单。用户需要指定交易对、订单类型（限价单、市价单等）、订单方向（买入、卖出）、下单价格（对于限价单）和下单数量等参数。在调用此端点之前，通常需要用户进行身份验证，并确保账户拥有足够的资金。此端点是进行交易的核心入口，必须确保安全性、可靠性和高效性。

4. 请求参数示例

对于创建订单的端点 /api/v1/order ，客户端需要提交一系列参数以确保订单能够被正确处理和执行。 以下是创建订单时可能使用的请求参数示例：

  • symbol (String, required): 交易对，指定要交易的资产对。例如，"BTCUSDT" 表示比特币兑美元泰达币的交易对。 交易对必须是平台支持的有效交易对。 不正确的交易对将导致订单创建失败。
  • side (String, required): 交易方向，指示是买入还是卖出。 可选值为 "BUY" 或 "SELL"。 "BUY" 表示买入指定交易对的第一个资产（例如，用 USDT 买入 BTC）， "SELL" 表示卖出指定交易对的第一个资产（例如，卖出 BTC 换取 USDT）。
  • type (String, required): 订单类型，定义订单的执行方式。 常用的订单类型包括 "LIMIT" 或 "MARKET"。 "LIMIT" 订单指定一个价格，只有当市场价格达到或超过该价格时才会执行。 "MARKET" 订单会立即以当前市场最佳价格执行。 根据交易所的不同，可能支持更多订单类型，如 "STOP_LOSS"、"TAKE_PROFIT" 等。
  • quantity (Number, required): 交易数量，表示要买入或卖出的资产数量。 数量必须是正数，并且通常需要满足交易所规定的最小交易数量限制。数量的精度也需要符合交易所的规定，超出精度的部分可能会被截断。
  • price (Number, optional): 订单价格 (仅限 LIMIT 订单)。 当订单类型为 "LIMIT" 时，此参数是必需的。 它指定了希望买入或卖出的价格。 例如，如果想以 30,000 USDT 的价格买入 BTC，则应将 price 设置为 30000。 如果订单类型为 "MARKET"，则不需要此参数。

5. 响应示例

获取交易对最新价格的端点 /api/v1/ticker 的响应示例如下。此端点提供特定交易对（如 BTCUSDT）的实时价格和交易量数据，对于构建交易机器人、监控市场动态或进行算法交易至关重要。 


{
  "symbol": "BTCUSDT",
  "price": "45000.00",
  "volume": "1000.00"
}

字段解释：

  • symbol : 交易对的代码，例如 BTCUSDT 表示比特币 (BTC) 兑美元泰达币 (USDT)。该字段唯一标识了交易市场，是查询特定交易对信息的关键参数。
  • price : 交易对的最新成交价格。此价格是当前市场上买方和卖方达成交易的价格，以报价货币（例如USDT）计价。 此价格数据实时更新，反映市场供需变化。
  • volume : 最近 24 小时内的交易量。 交易量以基础货币 (例如 BTC) 计价，代表了市场的活跃程度。 高交易量通常意味着市场流动性好，交易更容易执行。

使用场景：

  • 实时监控： 开发者可以利用此端点构建实时价格监控系统，及时了解市场波动。
  • 算法交易： 交易机器人可以根据 price 和 volume 数据自动执行交易策略。
  • 数据分析： 数据分析师可以利用历史价格数据进行趋势分析和预测。

6. 错误码示例

  • 400 : 无效的请求参数。这表示请求中包含的参数格式不正确、缺失必要参数，或者参数值超出了允许的范围。例如，时间戳格式错误、交易金额为负数、或者缺少必要的API密钥等都可能导致此错误。 客户端应仔细检查请求参数并确保其符合API文档的规范。
  • 401 : 身份验证失败。此错误表明客户端提供的身份验证信息（如API密钥、签名等）无效或已过期。这可能是由于密钥输入错误、密钥权限不足、或者密钥已被撤销所致。客户端应检查API密钥是否正确，以及该密钥是否具有执行所需操作的权限。确保密钥处于激活状态并且未被泄露。
  • 429 : 超出速率限制。为了保护服务器免受滥用，API通常会设置请求速率限制。此错误表示客户端在短时间内发送了过多的请求，超过了API允许的速率。 客户端应实现速率限制重试机制，例如指数退避，以便在遇到此错误时自动降低请求频率。 还可以考虑优化请求逻辑，减少不必要的请求。
  • 500 : 服务器内部错误。此错误表明服务器在处理请求时遇到了意外问题，例如代码缺陷、数据库连接失败、或者其他未知的内部错误。这通常不是客户端可以解决的问题，而是需要服务器端的开发人员进行修复。客户端可以尝试稍后重新发送请求，或者联系API提供商寻求支持。如果持续出现此错误，应及时报告给API提供商，以便他们能够诊断和解决问题。

7. 示例代码

本节提供Python代码示例，演示如何使用 requests 库与交易所API交互，包括调用端点和处理身份验证。强烈建议使用Python 3.6或更高版本。

requests 库用于发送HTTP请求， hashlib 和 hmac 库用于创建安全签名， time 库用于生成时间戳，这是许多API身份验证机制的关键部分。 

import requests
import hashlib
import hmac
import time

以下代码片段定义了API密钥、密钥和基础URL。务必替换 YOUR_API_KEY 和 YOUR_SECRET_KEY 为您的实际API凭据。切勿在公共存储库或客户端代码中泄露您的密钥。 

api_key = "YOUR_API_KEY"
secret_key = "YOUR_SECRET_KEY"
base_url = "https://api.exchange.com"

create_order 函数演示了如何创建订单。它接受交易对代码（ symbol ）、买/卖方向（ side ，例如"buy"或"sell"）、订单类型（ type ，例如"market"或"limit"）和数量（ quantity ）作为参数。对于限价单，还需要指定价格（ price ）。时间戳的生成至关重要，确保请求的有效性。 

def create_order(symbol, side, type, quantity, price=None):
    endpoint = "/api/v1/order"
    timestamp = str(int(time.time()))
    params = {
        "symbol": symbol,
        "side": side,
        "type": type,
        "quantity": quantity,
        "timestamp": timestamp
    }
    if price:
        params["price"] = price

为了确保请求的安全性，需要使用您的密钥对请求进行签名。以下代码段演示了如何创建签名。它构建一个查询字符串，对参数进行排序并连接成一个字符串。然后，它使用HMAC-SHA256算法对查询字符串进行签名。生成的签名作为 X-API-SIGNATURE 请求头发送。 

    query_string = '&'.join([f"{k}={v}" for k, v in params.items()])
    signature = hmac.new(secret_key.encode('utf-8'), query_string.encode('utf-8'), hashlib.sha256).hexdigest()
    headers = {
        "X-API-KEY": api_key,
        "X-API-SIGNATURE": signature
    }
    url = base_url + endpoint + "?" + query_string
    response = requests.post(url, headers=headers)
    return response.()

示例：创建一个市价买单

在加密货币交易中，市价单是一种以当前市场上最优价格立即执行的订单。这意味着，如果你想立即买入或卖出某种加密货币，你可以使用市价单。以下示例展示了如何通过编程方式创建一个针对BTCUSDT交易对的市价买单，买入数量为0.01个比特币。

order = create_order("BTCUSDT", "BUY", "MARKET", 0.01)

上述代码片段使用 create_order 函数创建了一个市价买单。该函数接受四个参数：

  • "BTCUSDT" : 这是交易对的符号，表示比特币兑泰达币。
  • "BUY" : 这是订单的方向， "BUY" 表示买入。
  • "MARKET" : 这是订单类型， "MARKET" 表示市价单。
  • 0.01 : 这是订单的数量，表示要买入0.01个比特币。

create_order 函数的返回值是一个包含订单信息的对象，例如订单ID、订单状态、成交价格等。

print(order)

此行代码将打印订单对象的内容，允许你查看订单的详细信息，例如订单的唯一标识符、订单的状态（例如，已提交、已成交、已取消）、成交的平均价格以及其他相关数据。通过检查订单对象，你可以确认订单是否已成功提交到交易所，并监控其执行状态。

注意事项：

  • 交易API的具体函数名和参数可能会因交易所而异。请参考你所使用的交易所的API文档。
  • 在实际交易中，务必进行风险管理，并确保你了解市价单的潜在风险，例如滑点。市价单会以当时市场上最优的价格成交，但由于市场波动，实际成交价格可能与下单时的预期价格略有差异。
  • 在执行真实交易前，建议先在测试环境（也称为沙盒环境）中进行测试，以确保你的代码能够正确运行。
  • 请务必妥善保管你的API密钥和私钥，避免泄露，以防止资金损失。

API文档是API开发人员和用户之间的桥梁。理解和利用API文档对于构建成功的应用程序至关重要。通过仔细阅读和分析API文档，开发者可以快速了解API的功能，并正确地使用它们。

The End

发布于：2025-03-05，除非注明，否则均为链探索原创文章，转载请注明出处。