开发者文档

开发者文档

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

RESTful API

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

WebSocket

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

多语言SDK

Python、JavaScript、Java、Go开箱即用

快速开始

// 存证请求示例
POST https://bqazzmu.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版本。