Developer Hub

黑料官网 API 与开发者中心

面向工程师的硬核接入指南：RESTful + GraphQL 双协议、6 种语言 SDK、OAuth 2.0 安全认证。

快速开始

1. 在定价页注册账号并获取 API_KEY。

2. 使用以下示例代码即可调用第一个接口：

# Python 调用示例
import requests

resp = requests.post(
  "https://api.uh59m.cn/v1/sentiment/analyze",
  headers={"Authorization": "Bearer YOUR_API_KEY"},
  json={"text": "这款产品体验非常出色，强烈推荐！", "lang": "zh"}
)
print(resp.json())
# => {"sentiment": "positive", "score": 0.92, "emotions": ["joy"]}

3. 完整接口文档请见下方 API 文档面板，支持在线沙盒调试。

认证机制

黑料官网提供两种认证方式：

API Key：适合服务端调用，简单直接。
OAuth 2.0：适合需要用户授权的第三方应用，支持 Authorization Code 与 Client Credentials 两种 Flow。

所有请求均通过 HTTPS 传输，配合签名验证防止重放攻击。详见数据安全声明。

交互式 API 文档面板

提供 "Try it out" 沙盒环境，直接在浏览器中发送真实请求，实时查看 JSON 响应。

SDK 与示例

Python SDK

pip install heiliao-sdk

Node.js SDK

npm i @heiliao/sdk

Java SDK

// Maven
<dependency>
  heiliao-sdk 1.0
</dependency>

Go SDK

go get heiliao/sdk

GraphQL Playground

POST /graphql
{ trend(brand:"x") }

Webhook 回调

POST your_url
{ "event": "alert" }

配额与限流

免费试用账号每日 1000 次调用配额；专业版 10 万次/月；企业版无限。所有响应头中均包含 X-RateLimit-Remaining 与 X-RateLimit-Reset 字段，便于客户端处理限流。

黑料 官网 API 与开发者中心