开发者文档

黑料网 - 区块链存证与数据验证平台 | 黑料官网为开发者提供完整的API接口和SDK工具包,帮助您快速将黑料网区块链存证能力集成到自己的应用中。

RESTful API

标准HTTP接口,支持JSON格式请求响应

WebSocket

实时数据推送,订阅区块和交易事件

多语言SDK

Python、JavaScript、Java、Go开箱即用

快速开始

// 存证请求示例
POST https://ndwftyi.cn/api/v1/attestation
Authorization: Bearer YOUR_API_KEY

{
  "data_hash": "0x7f3a8b2c9d4e5f6a...",
  "hash_algorithm": "sha256",
  "metadata": {"type": "document"}
}
// 响应示例
{
  "status": "success",
  "transaction_hash": "0x4a2b3c4d5e6f...",
  "block_height": 876432,
  "timestamp": "2024-01-15T08:30:00.000Z"
}

API端点列表

存证操作

  • POST /api/v1/attestation - 提交存证
  • GET /api/v1/attestation/{hash} - 查询状态
  • POST /api/v1/verify - 验证完整性

区块查询

  • GET /api/v1/blocks/latest - 最新区块
  • GET /api/v1/blocks/{height} - 按高度查询
  • GET /api/v1/transactions/{hash} - 交易详情

SDK安装

# Python
pip install blockchain-attestation-sdk
# JavaScript
npm install @blockchain-attestation/sdk
# Go
go get github.com/blockchain-attestation/sdk-go

错误码与速率限制

API使用标准HTTP状态码。免费版每分钟60次请求,专业版600次,企业版无限制。超限返回429状态码。

注册开发者账号后在控制台API管理页面生成,每个账号最多5个密钥。
官方支持Python 3.8+、JavaScript/TypeScript、Java 11+和Go 1.19+,社区贡献了Rust、C#和PHP版本。