速查！比特币REST API接口终极指南【开发者必备】

2025-03-05 23:57:06 38

比特币 REST API 接口文档概览

简介

比特币 REST API 提供了一种程序化访问比特币网络数据的强大途径，允许开发者在无需直接操作节点的情况下，以高效且便捷的方式获取链上信息。通过构造并发送 HTTP 请求至预定义的 API 端点，应用程序可以检索包括区块头、完整区块数据、交易确认状态、特定地址的 UTXO 集、以及更广泛的网络统计数据等信息。这些数据对于构建区块链浏览器、钱包应用程序、交易机器人、以及进行链上数据分析至关重要。

开发者可以利用这些 API 接口查询指定区块高度或哈希值的区块详情，包括其包含的交易列表、时间戳、难度目标等关键属性。对于交易信息，API 能够提供交易 ID (TXID)、输入输出、费用以及确认区块等详细信息。开发者还可以查询特定比特币地址的当前余额、历史交易记录以及未花费的交易输出 (UTXO)，这对于钱包应用至关重要。高级 API 功能可能还包括广播新交易到网络，或订阅特定事件（如新区块生成或交易确认）的回调服务。

需要注意的是，比特币并非只有一个统一的 API 标准。不同的比特币节点软件实现，例如 Bitcoin Core、btcd、Libbitcoin 等，都可能提供各自特有的 REST API 接口和数据格式。它们在认证方式、速率限制、可用端点以及返回的数据结构上都可能存在显著差异。因此，在使用任何比特币 REST API 之前，务必仔细查阅并理解所使用的特定节点软件的官方 API 文档。一些第三方服务也提供比特币 API 访问，它们通常会聚合来自不同节点的的数据，并提供额外的功能，但也需要权衡其可靠性和成本。

基本概念

  • 端点 (Endpoint): API 接口的具体 URL 地址，是客户端应用程序与服务器交互的通道。每个端点代表服务器上可访问的特定资源或功能。正确的端点对于成功调用 API 至关重要，错误的端点会导致请求失败或返回错误的数据。端点通常包含协议（如 HTTPS）、域名和资源路径。
  • 请求方法 (HTTP Method): 例如 GET, POST, PUT, DELETE 等，用于指定客户端对服务器资源执行的操作类型。GET 用于检索资源，POST 用于创建新资源，PUT 用于更新现有资源，DELETE 用于删除资源。选择正确的 HTTP 方法对于确保 API 的行为符合预期至关重要。例如，使用 GET 方法不应修改服务器上的任何数据。
  • 请求参数 (Request Parameters): 用于指定请求的附加信息，用于细化或过滤服务器返回的数据。请求参数可以通过 URL 查询字符串（如 `?param1=value1&param2=value2`）或请求体（在 POST、PUT 等请求中）传递。参数可以是必需的或可选的，API 文档通常会详细说明每个参数的用途和格式。有效使用请求参数可以提高 API 调用的效率和精确性。
  • 响应 (Response): 服务器返回的数据，通常是 JSON 格式，但也可能是 XML 或其他格式。响应通常包含状态码（指示请求是否成功）和响应体（包含实际的数据）。状态码为 200 表示成功，400 表示客户端错误，500 表示服务器错误。理解响应的结构和状态码对于调试 API 调用和处理潜在的错误至关重要。
  • JSON (JavaScript Object Notation): 一种轻量级的数据交换格式，易于阅读和解析，被广泛用于 API 通信。JSON 采用键值对的结构，易于理解和生成。几乎所有编程语言都提供对 JSON 的支持，使其成为不同系统之间交换数据的理想选择。JSON 的简洁性和可读性使其在加密货币领域的 API 中尤为受欢迎。

常见 API 接口

以下是一些常见的比特币 REST API 接口，用于与比特币节点进行交互。这些接口允许开发者查询区块链数据、发送交易以及管理钱包。具体实现和参数可能会因节点版本、配置以及所使用的比特币客户端（如 Bitcoin Core）而异。

这些 API 通常通过 HTTP 协议进行调用，返回的数据格式通常为 JSON。访问这些 API 通常需要进行身份验证，具体验证方式取决于节点的配置。

需要注意的是，直接操作比特币节点的 API 存在安全风险，务必在安全的受控环境下进行，并采取必要的安全措施，如限制 API 的访问权限，定期更新节点软件等。

1. 区块链信息

  • 获取区块链信息:
    • 端点: /rest/chaininfo
    • 方法: GET
    • 描述: 返回关于区块链的综合信息。这些信息涵盖链的标识 (例如， main 主链、 test 测试链、 regtest 回归测试链), 当前的区块高度，区块链的头部哈希值，挖矿难度目标值，以及其他关键的区块链参数。 这些参数对于监控网络状态、验证区块链同步状态以及理解链的整体运行状况至关重要。
    • 响应示例:

    {
    "chain": "main",
    "blocks": 790000,
    "headers": 790000,
    "bestblockhash": "00000000000000000004d364f56d1794f274c66036948c0e5f051249266e7d6c",
    "difficulty": 35000000000,
    "mediantime": 1688000000,
    "verificationprogress": 0.99999,
    "chainwork": "000000000000000000000000000000000000000000000000000000000000000",
    "pruned": false,
    "softforks": [
    {
    "id": "bip34",
    "version": 2,
    "enforce": {
    "status": true,
    "found": 700000,
    "required": 750000,
    "window": 100000
    },
    "reject": {
    "status": true,
    "found": 700000,
    "required": 750000,
    "window": 100000
    }
    }
    ],
    "warnings": ""
    }

  • 获取区块头:
    • 端点: /rest/headers/ / .bin (二进制格式) 或 /rest/headers/ / (JSON 格式)
    • 方法: GET
    • 描述: 返回从指定的起始区块哈希开始的，指定数量 ( count ) 的连续区块头信息。区块头包含了区块的关键元数据，如前一个区块的哈希、Merkle 根以及时间戳。这些信息对于验证区块链的完整性和构建区块链索引至关重要。
    • 参数:
      • count : 需要返回的区块头数量。 这个参数允许用户批量检索区块头，从而提高数据获取的效率。
      • blockhash : 作为起点的区块的哈希值。 所有返回的区块头都将以此哈希所对应的区块为起点，沿着区块链向上追溯。
    • 注意: 二进制格式提供了更高的紧凑性，适合对带宽敏感的应用场景。 JSON 格式则提供了更好的可读性，方便调试和开发。选择哪种格式取决于具体的使用需求和应用场景。
  • 获取区块:
    • 端点: /rest/block/ .bin (二进制格式) 或 /rest/block/ (JSON 格式)
    • 方法: GET
    • 描述: 返回特定区块哈希所对应的区块的完整信息。这些信息包括区块头、交易列表以及其他相关的区块元数据。通过检索区块数据，用户可以深入了解区块链上发生的具体交易和状态变化。
    • 参数:
      • blockhash : 想要获取的区块的唯一哈希标识符。 该哈希值能够精确定位到区块链上的特定区块。
    • 注意: 由于区块数据可能包含大量的交易信息，特别是对于那些包含大量交易的区块，其数据量可能相当大。因此，在获取区块数据时，需要考虑到网络带宽和处理能力，并根据实际情况选择合适的数据格式和获取方式。

2. 交易信息

  • 获取交易:
    • 端点: /rest/tx/ .bin (二进制格式) 或 /rest/tx/ . (JSON 格式) 或 /rest/tx/ .hex (十六进制格式)
    • 方法: GET
    • 描述: 返回指定交易的详细信息，允许开发者获取关于特定交易的各种属性，包括输入、输出、交易费用、确认数等。 可以通过选择不同的文件扩展名来指定响应的数据格式。
    • 参数:
      • txid : 必需参数，代表要查询的交易的唯一标识符 (Transaction ID)，通常是一个 64 位的十六进制字符串。 此参数区分大小写，必须准确提供。
    • 响应示例: 以下是一个 JSON 格式的响应示例，展示了交易的各种属性。 请注意，实际的响应可能会因交易类型和区块链实现而有所不同。

    { "txid": "e283a60b2e42d117747038c2d61698b63769e5c6d69d3f98d277741b4ffc748a", "hash": "e283a60b2e42d117747038c2d61698b63769e5c6d69d3f98d277741b4ffc748a", "version": 2, "size": 225, "vsize": 141, "weight": 564, "locktime": 0, "vin": [ { "txid": "a2b149f981a33b81c2f566c9b122109f0c76d981f2514554220e56d3b79a71f1", "vout": 0, "scriptSig": { "asm": "3045022100c81f9c75d9a0915b1c3c12492614f38c6026b70c5d355e3240c3a5d4e0d29387022040e522efc87246b8660e83b4b1a2c2c49e522f8a807a8340e08771a7826f4320[ALL]", "hex": "473045022100c81f9c75d9a0915b1c3c12492614f38c6026b70c5d355e3240c3a5d4e0d29387022040e522efc87246b8660e83b4b1a2c2c49e522f8a807a8340e08771a7826f432001" }, "sequence": 4294967295 } ], "vout": [ { "value": 0.00040000, "n": 0, "scriptPubKey": { "asm": "OP_DUP OP_HASH160 8682dd6609e71206d1c386c035b5a3b79897c504 OP_EQUALVERIFY OP_CHECKSIG", "hex": "76a9148682dd6609e71206d1c386c035b5a3b79897c50488ac", "reqSigs": 1, "type": "pubkeyhash", "addresses": [ "1DaQ8aW43yQf6Wn5R6W535N1M1N7B13jY" ] } }, { "value": 0.00050000, "n": 1, "scriptPubKey": { "asm": "OP_DUP OP_HASH160 876534aa68865b7a2b05914e616490d3f6f76043 OP_EQUALVERIFY OP_CHECKSIG", "hex": "76a914876534aa68865b7a2b05914e616490d3f6f7604388ac", "reqSigs": 1, "type": "pubkeyhash", "addresses": [ "1DhT8H5Yf5E9zKqF2zQn75f93D6C6346D" ] } } ], "blockhash": "0000000000000000000732f49b6f4361b33533e128838d407166b02d33a06c48", "confirmations": 118, "time": 1687925722, "blocktime": 1687925722 }

3. 内存池 (Mempool) 信息

  • 获取内存池内容

    • 端点: /rest/mempool/contents
    • 方法: GET
    • 描述: 该端点提供对当前内存池中所有未确认交易的详细访问。内存池是节点在将交易打包到区块之前，临时存储等待确认的交易的区域。通过此端点，您可以检索到交易ID、交易大小、交易费用以及交易首次被节点观察到的时间等关键信息。这对于分析网络拥塞情况、评估交易费用策略以及监控特定交易的状态非常有用。
    • 注意: 内存池的内容是动态的，会随着新交易的提交和区块的产生而不断变化。因此，每次请求的结果都可能不同。建议在需要实时监控内存池状态时，定期调用此端点。不同节点的内存池内容可能略有差异，因为各个节点接收和传播交易的顺序可能不同。

  • 获取内存池信息

    • 端点: /rest/mempool/info
    • 方法: GET
    • 描述: 此端点提供内存池的全局统计信息，帮助您了解网络的整体交易处理能力。返回的信息通常包括内存池的总大小（以字节为单位）、当前包含的交易数量、最高交易费用和最低交易费用等。这些数据可以用于评估网络的拥塞程度，并预测交易确认所需的时间。
    • 补充说明: 除了上述基本信息，一些实现可能会提供更详细的统计数据，例如每秒接收的交易数量、不同费用等级的交易分布情况以及内存池的容量限制。通过分析这些数据，可以更好地理解网络的运行状况，并制定相应的策略来优化交易处理。例如，在高拥塞时期，可以提高交易费用以加快确认速度。

4. 地址信息 (部分节点支持)

  • 获取地址UTXO:
    • 端点： /rest/getutxos/
    • 方法：GET
    • 描述：返回指定地址未花费的交易输出(UTXO)信息。 UTXO代表比特币网络上尚未使用且可用于新交易的输出。 通过查询特定地址的UTXO，可以了解该地址目前可用的比特币数量以及这些比特币来源于哪些交易。 该接口对于构建钱包和交易等应用至关重要。
    • 参数：
      • address : 要查询的比特币地址。 比特币地址通常以'1'、'3'或'bc1'开头，用于接收比特币。 例如：`1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2`。
    • 示例：

      例如，要获取地址`1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2`的UTXO信息，可以使用如下请求：

      GET /rest/getutxos/1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2

      返回的JSON数据将包含该地址的所有UTXO，包括交易哈希(txid)、输出索引(vout)、脚本PubKey(scriptPubKey)和金额(value)。

  • 获取地址历史:
    • 端点：可能需要安装额外的索引插件，具体端点依插件而定，例如`addressindex`。 常见的端点格式可能为 /rest/address/
      /txs
      。 请查阅您使用的比特币节点软件的文档以获取准确的端点信息。
    • 方法：GET
    • 描述：返回指定地址的交易历史记录。 这包括发送到该地址和从该地址发送的所有交易。 交易历史记录提供了地址活动的完整视图，可用于审计、追踪资金流动和分析地址行为。
    • 注意：需要节点配置支持地址索引。 默认情况下，比特币核心节点不启用地址索引以节省存储空间和提高性能。 您需要在`bitcoin.conf`文件中启用`addressindex=1`选项，并重新启动节点才能使用此功能。 请注意，启用地址索引会显著增加节点的存储需求。
    • 示例：

      如果您的节点使用`addressindex`插件，并且端点为`/rest/address/

      /txs`，那么获取地址`1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2`历史的请求可能如下：

      GET /rest/address/1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2/txs

      返回的JSON数据将包含与该地址相关的所有交易的列表，包括交易哈希(txid)、区块高度(blockheight)和时间戳(timestamp)。

安全注意事项

  • 身份验证: 加密货币 API 访问通常需要身份验证机制。 这可能包括基于用户名和密码的传统身份验证，更常见的是使用 API 密钥或令牌。API 密钥是分配给每个用户的唯一字符串，用于验证其身份并授权其访问特定资源。 安全地存储和管理您的 API 密钥至关重要，避免将其硬编码到应用程序中，而是使用环境变量或安全的配置管理系统。 某些高级 API 可能采用 OAuth 2.0 等协议，允许用户授予第三方应用程序访问其数据的权限，而无需共享其密码。
  • 速率限制: 为防止滥用和维持 API 服务的稳定性和可用性，大多数加密货币 API 提供商都会实施速率限制。 速率限制规定了在给定的时间段内（例如每分钟、每小时或每天）客户端可以向 API 发出的最大请求数量。 超过速率限制通常会导致 API 返回错误代码（例如 429 Too Many Requests）。 为了避免速率限制，开发人员应实施重试机制、缓存 API 响应，并优化其应用程序以减少不必要的 API 调用。 某些 API 提供商可能会提供不同的定价层，这些层具有不同的速率限制，允许用户根据自己的需求选择最合适的层。 仔细阅读 API 文档，了解速率限制策略及其含义至关重要。
  • HTTPS: 使用 HTTPS（安全超文本传输协议）对于保护通过加密货币 API 传输的数据至关重要。 HTTPS 通过使用 SSL/TLS 协议对客户端和服务器之间的通信进行加密，从而防止中间人攻击，确保数据的机密性和完整性。 始终验证您连接的 API 端点是否使用 HTTPS。 这可以通过检查 URL 是否以 "https://" 开头，以及验证浏览器是否显示安全连接指示器（例如挂锁图标）来完成。 避免使用 HTTP 连接，因为它以未加密的纯文本形式传输数据，容易被拦截和篡改。
  • 节点选择: 当与比特币或其他加密货币网络交互时，选择可信赖的节点提供商至关重要。节点提供商运行完整的区块链节点，并向客户端提供访问区块链数据的接口。 不可信的或恶意的节点可能会返回不正确或被篡改的数据，从而导致财务损失或其他安全漏洞。 研究和选择信誉良好且具有良好安全记录的节点提供商。 考虑节点提供商的正常运行时间、延迟和数据准确性。 某些节点提供商还提供额外的安全功能，例如 DDoS 防护和速率限制。 您可以选择运行自己的完整节点，但这需要大量的技术专业知识和资源。 使用轻量级客户端（如 SPV 客户端）也需要信任一组节点，因此节点选择同样重要。

数据格式

API 响应通常采用 JSON（JavaScript Object Notation）格式，这是一种轻量级的数据交换格式，易于阅读和编写，同时也方便机器解析和生成。JSON 基于 JavaScript 的一个子集，但独立于编程语言，因此被广泛应用于 Web API 的数据传输。你需要使用 JSON 解析库来处理这些数据，以便提取所需的信息。例如，在 Python 中，你可以利用内置的 模块进行 JSON 数据的序列化（编码）和反序列化（解码）。

JSON 数据由键值对组成，可以表示简单的数据类型（如字符串、数字、布尔值）以及复杂的数据结构（如数组和嵌套对象）。在处理 API 响应时，你需要了解返回 JSON 数据的结构，才能正确地提取数据。常见的做法是先将 JSON 字符串解析为 Python 字典或列表，然后通过键或索引访问相应的值。不同的编程语言都有相应的 JSON 解析库，例如 JavaScript 中的 JSON.parse() 和 JSON.stringify() ，Java 中的 org. 库，以及 PHP 中的 _encode() 和 _decode() 函数。

错误处理

在使用 API 接口时，可能会遇到各种错误情况。API 通常会返回 HTTP 状态码以及错误信息，用于指示请求的处理结果。例如，常见的错误代码包括：

  • 400 Bad Request (错误请求): 表示客户端发送的请求存在语法错误或参数不符合 API 的要求，服务器无法理解。通常需要检查请求参数是否正确，数据类型是否匹配，以及是否缺少必要的参数。
  • 401 Unauthorized (未授权): 表示客户端尝试访问受保护的资源，但未提供有效的身份验证凭据（如 API 密钥或令牌）。需要提供正确的凭据，才能获得访问权限。
  • 403 Forbidden (禁止访问): 表示客户端已通过身份验证，但没有权限访问请求的资源。即使提供有效的凭据，服务器也拒绝提供服务。这可能是由于权限不足、账户限制或其他安全策略导致的。
  • 404 Not Found (未找到): 表示请求的资源在服务器上不存在。可能是 URL 地址错误，或者资源已被删除。需要检查 URL 地址是否正确。
  • 429 Too Many Requests (请求过多): 表示客户端在短时间内发送了过多的请求，超过了 API 的速率限制。需要减少请求频率，或申请更高的速率限制。通常API会通过header返回剩余请求次数和重置时间。
  • 500 Internal Server Error (服务器内部错误): 表示服务器在处理请求时遇到了意外错误。这通常是服务器端的问题，客户端无法直接解决。可以稍后重试，或联系 API 提供商寻求帮助。
  • 502 Bad Gateway (错误的网关): 表示服务器作为网关或代理，从上游服务器收到了无效的响应。 这通常是服务器端的问题，客户端无法直接解决。可以稍后重试，或联系 API 提供商寻求帮助。
  • 503 Service Unavailable (服务不可用): 表示服务器暂时无法处理请求，通常是由于服务器过载或维护。可以稍后重试。
  • 504 Gateway Timeout (网关超时): 表示服务器作为网关或代理，在上游服务器等待响应超时。 这通常是服务器端的问题，客户端无法直接解决。可以稍后重试，或联系 API 提供商寻求帮助。

针对不同的错误代码，你应该采取相应的错误处理策略。例如，对于 400 错误，应检查并修复请求参数；对于 401 或 403 错误，应检查身份验证信息和权限设置；对于 404 错误，应检查 URL 地址；对于 5xx 错误，可以稍后重试或联系 API 提供商。在代码中，可以使用 try-except 块来捕获异常，并进行相应的处理，例如记录错误日志、向用户显示错误信息或重试请求。

除了 HTTP 状态码，API 还可能在响应体中返回更详细的错误信息，例如错误代码、错误消息和错误描述。你应该解析响应体，并根据这些信息来诊断和解决问题。许多 API 提供商会提供详细的错误代码文档，可以参考这些文档来了解各种错误的含义和解决方法。

例子 (Python)

以下是一个使用Python与REST API交互，例如获取加密货币数据的简单示例。为了完成这个任务，我们将使用 requests 库，这是一个流行的、易于使用的HTTP库。你需要确保已经安装了这个库。如果未安装，可以使用 pip install requests 命令进行安装。

导入 requests 库： 

import requests

然后，你可以使用 requests.get() 方法向API endpoint发送GET请求。例如，假设你想从某个加密货币交易所API获取比特币（BTC）的价格： 

import requests

# API Endpoint (这里需要替换成实际的API地址)
api_url = "https://api.example.com/v1/ticker/btc-usd"

try:
    # 发送GET请求
    response = requests.get(api_url)

    # 检查响应状态码
    response.raise_for_status()  # 如果状态码不是200，会抛出HTTPError

    # 将响应内容解析为JSON格式
    data = response.()

    # 从JSON数据中提取价格信息 (这里需要根据实际的API返回格式调整)
    price = data["price"]

    # 打印比特币价格
    print(f"比特币价格: {price}")

except requests.exceptions.HTTPError as errh:
    print(f"HTTP Error: {errh}")
except requests.exceptions.ConnectionError as errc:
    print(f"连接错误: {errc}")
except requests.exceptions.Timeout as errt:
    print(f"超时错误: {errt}")
except requests.exceptions.RequestException as err:
    print(f"请求错误: {err}")
except KeyError:
    print("KeyError: API 响应格式可能不正确，无法找到 'price' 字段。")
except Exception as e:
    print(f"发生未知错误: {e}")

代码解释:

  • import requests : 导入 requests 库。
  • api_url : 替换成你要使用的加密货币API的实际URL。不同的交易所和数据提供商有不同的API endpoint。
  • requests.get(api_url) : 发送GET请求到指定的API endpoint。
  • response.raise_for_status() : 检查HTTP响应状态码。如果状态码表示错误（例如 404 或 500），会抛出一个异常，以便你可以处理错误情况。
  • response.() : 将服务器返回的JSON格式的数据解析为Python字典或列表。
  • data["price"] : 从解析后的JSON数据中提取比特币的价格。你需要根据API返回的具体格式修改这个键名。
  • try...except 块: 用于捕获可能发生的异常，例如网络连接错误、API响应错误等，从而使程序更加健壮。常见的异常包括：
    • requests.exceptions.HTTPError : HTTP 错误，例如 404 Not Found。
    • requests.exceptions.ConnectionError : 网络连接错误。
    • requests.exceptions.Timeout : 请求超时。
    • requests.exceptions.RequestException : 其他请求相关的错误。
    • KeyError : 如果API返回的JSON数据中不包含期望的 "price" 字段，会抛出 KeyError 异常。
    • Exception : 用于捕获所有其他未预料到的异常。

重要提示:

  • API Key: 某些API可能需要API密钥才能访问。如果需要API密钥，你需要在请求中包含它，通常是在请求头中或者作为URL参数。
  • 错误处理: 务必进行适当的错误处理，以应对API调用失败的情况。
  • API 文档: 阅读你使用的API的官方文档，了解API endpoint的格式、请求参数、响应格式以及错误代码等信息。
  • 速率限制: 注意API的速率限制（rate limiting），避免过于频繁地发送请求，以免被API封禁。
  • 安全性: 如果API涉及敏感数据（例如API密钥），请注意保护你的API密钥，不要将其泄露给他人。避免将API密钥硬编码到代码中，而是使用环境变量或配置文件来管理API密钥。

获取区块链信息

要查询区块链的当前状态，您可以通过REST接口访问节点信息。以下代码展示了如何构建请求URL以获取区块链链信息。

url = "http://localhost:8332/rest/chaininfo."

解释：

  • http://localhost:8332 : 这部分是您的Bitcoin Core或其他兼容节点的地址和端口。 localhost 表示节点运行在本地计算机上， 8332 是默认的 Bitcoin Core RPC 端口。如果您的节点运行在不同的机器或使用了不同的端口，请替换为正确的地址和端口。
  • /rest/chaininfo. : 这部分指定了要访问的REST接口的路径。 /rest/ 表示使用 REST 接口， chaininfo 是要查询的具体信息（即链信息）， . 指定了返回的数据格式为 JSON。 您还可以使用 .xml 获取 XML 格式的数据。

安全提示: 请确保只有受信任的客户端才能访问您的节点的REST接口，避免暴露敏感信息。可以使用防火墙或身份验证机制来保护您的节点。

重要提示: 启用REST接口需要在 Bitcoin Core 配置文件 ( bitcoin.conf ) 中设置 rest=1 ，并重启节点。 建议配置 whitelist 选项限制可以访问REST接口的IP地址范围，提升安全性。例如 whitelist=127.0.0.1 只允许本地访问。

注意：如果需要身份验证，请添加 auth 参数

身份验证： auth=('your_username', 'your_password')

尝试进行带有身份验证的HTTP GET请求。身份验证信息以元组形式提供，包含用户名和密码。
requests 库会自动处理身份验证头信息。

try: 语句块用于捕获可能发生的异常。 


    response = requests.get(url, auth=('your_username', 'your_password'))

使用 requests.get() 函数发送GET请求，并将身份验证信息作为 auth 参数传递。
url 变量应包含请求的目标URL。

response.raise_for_status() 方法检查响应状态码。
如果状态码表示错误（例如 404 或 500），则会引发 HTTPError 异常。 


    try:
        response = requests.get(url, auth=('your_username', 'your_password'))
        response.raise_for_status()
        data = response.()
        print(.dumps(data, indent=4, ensure_ascii=False))
    except requests.exceptions.RequestException as e:
        print(f"请求失败: {e}")
    except .JSONDecodeError as e:
        print(f"JSON解析失败: {e}")

data = response.() 将响应内容解析为JSON格式。
确保响应头 Content-Type 设置为 application/ 。

print(.dumps(data, indent=4, ensure_ascii=False)) 使用 .dumps() 函数格式化输出JSON数据。
indent=4 参数指定缩进级别为4个空格，提高可读性。
ensure_ascii=False 参数确保输出中包含Unicode字符，而不是ASCII转义序列。

except requests.exceptions.RequestException as e: 捕获任何与请求相关的异常，例如网络连接错误或超时。
except .JSONDecodeError as e: 捕获JSON解析错误，例如响应内容不是有效的JSON格式。

print(f"请求失败: {e}") 或 print(f"JSON解析失败: {e}") 打印错误信息，帮助调试。

获取某个区块的信息

要检索特定区块的详细信息，您可以使用比特币节点的REST接口。以下代码段展示了如何通过区块哈希值获取区块信息。

blockhash = "00000000000000000004d364f56d1794f274c66036948c0e5f051249266e7d6c" # 替换为实际的区块哈希

将上述 blockhash 变量替换为您希望查询的实际区块哈希值。区块哈希值是唯一标识区块链中每个区块的十六进制字符串。

url = f"http://localhost:8332/rest/block/{blockhash}."

此行代码定义了REST API的URL。 http://localhost:8332 是比特币节点运行的默认地址和端口。 /rest/block/ 指定要访问区块信息。 {blockhash} 会被替换为变量中的实际哈希值。 . 后缀指定以JSON格式返回数据。

以下代码使用Python的 requests 库发送HTTP GET请求，并处理可能发生的任何错误：

try: response = requests.get(url) response.raise_for_status() # 如果响应状态码不是 200，则引发 HTTPError 异常 data = response.() print(.dumps(data, indent=4)) except requests.exceptions.RequestException as e: print(f"请求失败: {e}")

这段代码块首先尝试发送GET请求。 response.raise_for_status() 会检查HTTP响应状态码，并在状态码表示错误时引发异常。如果请求成功， response.() 会将响应内容解析为Python字典。 .dumps(data, indent=4) 以易于阅读的格式打印JSON数据。如果请求过程中发生任何异常（例如，网络错误或无效的区块哈希），则会捕获该异常并打印错误消息。

请注意，上述代码需要安装 requests 库。您可以使用以下命令安装它： pip install requests 。请确保您的比特币节点已启用REST接口。您需要在比特币配置文件的 bitcoin.conf 中设置 rest=1 。

bitcoin.conf 配置示例： 

# 启用 REST 接口
rest=1

# (可选) 设置 RPC 用户名和密码
rpcuser=yourusername
rpcpassword=yourpassword

# (可选) 设置监听地址 (默认为 127.0.0.1)
rpclisten=0.0.0.0

# (可选) 设置监听端口 (默认为 8332)
rpcport=8332

请根据您所使用的比特币节点实现和具体需求来调整API调用和配置文件。务必仔细阅读相关文档，并确保节点已正确配置。

The End

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