大数据 API 调用说明

# 1. 获取令牌
curl -X POST "https://api.wchc888.cn/bigdata/v1/oauth/token" \
  -H "Content-Type: application/json" \
  -d '{
    "app_key": "hc_demo_9f3ac2",
    "app_secret": "********"
  }'

# 2. 调用业务接口
curl -G "https://api.wchc888.cn/bigdata/v1/enterprise/info" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiJ9..." \
  -d "keyword=海南禾泰水产有限公司"

import hashlib, hmac, time

APP_KEY    = "hc_demo_9f3ac2"
APP_SECRET = "your_app_secret"

def sign(method: str, path: str, params: dict) -> dict:
    ts = str(int(time.time()))
    query = "&".join(f"{k}={params[k]}" for k in sorted(params))
    raw = f"{method.upper()}\n{path}\n{ts}\n{query}"
    sign = hmac.new(APP_SECRET.encode(), raw.encode(), hashlib.sha256).hexdigest().upper()
    return {
        "X-HC-Key": APP_KEY,
        "X-HC-Timestamp": ts,
        "X-HC-Signature": sign,
    }

{
  "code": 0,                // 业务码，0 = 成功
  "message": "success",     // 人类可读描述
  "request_id": "req_8f1e0a3b7c",  // 链路追踪 ID，反馈问题时必附
  "data": { }               // 业务数据，失败时为 null
}

{
  "code": 0,
  "message": "success",
  "request_id": "req_token_01hx92",
  "data": {
    "access_token": "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJoY19kZW1vIn0.dQw4w9WgXcQ",
    "token_type": "Bearer",
    "expires_in": 7200,
    "scope": "enterprise:r enterprise:risk industry:r region:r nlp:r report:w"
  }
}

curl -G "https://api.wchc888.cn/bigdata/v1/enterprise/info" \
  -H "Authorization: Bearer $TOKEN" \
  -d "credit_code=91469005MA5T1234XA" \
  -d "with_shareholders=true"

{
  "code": 0,
  "message": "success",
  "request_id": "req_ent_5521",
  "data": {
    "credit_code": "91469005MA5T1234XA",
    "name": "海南禾泰水产有限公司",
    "legal_person": "陈某某",
    "reg_capital_wan": 500.00,
    "establish_date": "2018-03-12",
    "status": "在营",
    "industry": "渔业 · 水产养殖",
    "address": "海南省文昌市××镇××路 12 号",
    "shareholders": [
      { "name": "陈某某", "ratio": 62.50 },
      { "name": "符某某", "ratio": 37.50 }
    ],
    "data_updated_at": "2026-09-10T08:00:00+08:00"
  }
}

{
  "code": 0,
  "message": "success",
  "request_id": "req_risk_0031",
  "data": {
    "credit_code": "91469005MA5T1234XA",
    "risk_score": 18,
    "risk_level": "低风险",
    "items": {
      "judicial":  { "score": 10, "lawsuits": 0, "dishonest": false },
      "operation": { "score": 22, "abnormal": false, "warnings": ["注册资本近一年未实缴到位"] },
      "finance":   { "score": 15, "tax_arrears": false },
      "credit":    { "score": 20, "blacklists": [] }
    },
    "evaluated_at": "2026-09-15T22:10:00+08:00"
  }
}

{
  "code": 0,
  "message": "success",
  "request_id": "req_trd_7788",
  "data": {
    "industry_code": "A01",
    "industry_name": "农业",
    "granularity": "month",
    "series": [
      { "period": "2026-07", "index": 103.4, "yoy": 2.1, "mom": 0.6 },
      { "period": "2026-08", "index": 104.1, "yoy": 2.8, "mom": 0.7 }
    ]
  }
}

curl -G "https://api.wchc888.cn/bigdata/v1/region/economy" \
  -H "Authorization: Bearer $TOKEN" \
  -d "region_code=469005" -d "year=2025"

{
  "code": 0,
  "message": "success",
  "request_id": "req_reg_2049",
  "data": {
    "region_code": "469005",
    "region_name": "文昌市",
    "year": 2025,
    "gdp_yi": 342.76,
    "gdp_yoy": 6.8,
    "fiscal_revenue_yi": 28.15,
    "population_wan": 55.8,
    "industry_structure": { "primary": 38.2, "secondary": 16.4, "tertiary": 45.4 },
    "source": "演示数据 · 非官方统计"
  }
}

curl -X POST "https://api.wchc888.cn/bigdata/v1/nlp/sentiment" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "texts": ["羊绒衫质量很好，穿着很暖和", "物流太慢，包装破损"],
    "with_keywords": true,
    "domain": "ecommerce"
  }'

{
  "code": 0,
  "message": "success",
  "request_id": "req_nlp_9a2c",
  "data": {
    "results": [
      {
        "label": "positive", "score": 0.9641,
        "probabilities": { "positive": 0.9641, "neutral": 0.0302, "negative": 0.0057 },
        "keywords": ["质量", "暖和"]
      },
      {
        "label": "negative", "score": 0.9123,
        "probabilities": { "positive": 0.0110, "neutral": 0.0767, "negative": 0.9123 },
        "keywords": ["物流", "包装破损"]
      }
    ],
    "billed_count": 2
  }
}

# 提交任务
curl -X POST "https://api.wchc888.cn/bigdata/v1/report/tasks" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "template_code": "region_report",
    "params": { "region_code": "469005", "year": 2025 },
    "format": "pdf",
    "callback_url": "https://your-app.example.com/hc-callback"
  }'

# 查询状态（GET /report/tasks/{task_id}，免费）
curl "https://api.wchc888.cn/bigdata/v1/report/tasks/task_20260917_7f3e" \
  -H "Authorization: Bearer $TOKEN"

{
  "code": 0,
  "message": "success",
  "request_id": "req_task_7f3e",
  "data": {
    "task_id": "task_20260917_7f3e",
    "status": "SUCCEEDED",
    "progress": 100,
    "file_url": "https://files.wchc888.cn/demo/region_469005_2025.pdf",
    "file_size": 1048576,
    "expire_at": "2026-09-24T00:00:00+08:00"
  }
}

{
  "code": 0, "message": "success", "request_id": "req_qta_0007",
  "data": {
    "plan": "basic",
    "qps_limit": 20,
    "daily":  { "used": 3120, "limit": 500000, "reset_at": "2026-09-18T00:00:00+08:00" },
    "monthly":{ "used": 45201, "limit": 500000, "reset_at": "2026-10-01T00:00:00+08:00" },
    "tasks_running": 1
  }
}

POST /hc-callback HTTP/1.1
Host: your-app.example.com
X-HC-Event: report.completed
X-HC-Signature: 3F9A1C...（演示值）

{
  "event": "report.completed",
  "event_id": "evt_01hx93kq",
  "created_at": "2026-09-17T21:40:12+08:00",
  "data": {
    "task_id": "task_20260917_7f3e",
    "status": "SUCCEEDED",
    "file_url": "https://files.wchc888.cn/demo/region_469005_2025.pdf",
    "cost": 2.00
  }
}

import requests

BASE = "https://api.wchc888.cn/bigdata/v1"
APP_KEY, APP_SECRET = "hc_demo_9f3ac2", "your_app_secret"

def get_token():
    r = requests.post(f"{BASE}/oauth/token",
                      json={"app_key": APP_KEY, "app_secret": APP_SECRET}, timeout=10)
    r.raise_for_status()
    return r.json()["data"]["access_token"]

def query_region(code: str, year: int):
    headers = {"Authorization": f"Bearer {get_token()}"}
    r = requests.get(f"{BASE}/region/economy",
                     headers=headers, params={"region_code": code, "year": year}, timeout=10)
    body = r.json()
    if body["code"] != 0:
        raise RuntimeError(f'[{body["code"]}] {body["message"]} (request_id={body["request_id"]})')
    return body["data"]

if __name__ == "__main__":
    print(query_region("469005", 2025))

<?php
$base  = "https://api.wchc888.cn/bigdata/v1";
$appKey = "hc_demo_9f3ac2";
$appSecret = "your_app_secret";

function hcPost($url, array $payload): array {
    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_POST           => true,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT        => 15,
        CURLOPT_HTTPHEADER     => ["Content-Type: application/json"],
        CURLOPT_POSTFIELDS     => json_encode($payload, JSON_UNESCAPED_UNICODE),
    ]);
    $body = curl_exec($ch);
    if ($body === false) { throw new RuntimeException(curl_error($ch)); }
    curl_close($ch);
    return json_decode($body, true);
}

$token = hcPost("$base/oauth/token",
    ["app_key" => $appKey, "app_secret" => $appSecret]
)["data"]["access_token"];

$ch = curl_init("$base/enterprise/info?keyword=" . urlencode("海南禾泰水产有限公司"));
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ["Authorization: Bearer {$token}"],
]);
var_dump(json_decode(curl_exec($ch), true));

const BASE = "https://api.wchc888.cn/bigdata/v1";
const APP_KEY = "hc_demo_9f3ac2";
const APP_SECRET = "your_app_secret";

async function main() {
  const tokenRes = await fetch(`${BASE}/oauth/token`, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ app_key: APP_KEY, app_secret: APP_SECRET }),
  }).then(r => r.json());

  const token = tokenRes.data.access_token;

  const res = await fetch(`${BASE}/industry/trend?industry_code=A01&start_month=2026-07&end_month=2026-08`, {
    headers: { Authorization: `Bearer ${token}` },
  }).then(r => r.json());

  if (res.code !== 0) throw new Error(`[${res.code}] ${res.message} (${res.request_id})`);
  console.table(res.data.series);
}

main().catch(console.error);

import java.net.URI;
import java.net.http.*;
import java.time.Duration;

public class HcBigDataDemo {
    static final String BASE = "https://api.wchc888.cn/bigdata/v1";
    static final HttpClient CLIENT = HttpClient.newBuilder()
            .connectTimeout(Duration.ofSeconds(10)).build();

    public static void main(String[] args) throws Exception {
        String tokenReq = "{\"app_key\":\"hc_demo_9f3ac2\",\"app_secret\":\"your_app_secret\"}";
        HttpResponse<String> tokenRes = CLIENT.send(HttpRequest.newBuilder()
                .uri(URI.create(BASE + "/oauth/token"))
                .header("Content-Type", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(tokenReq)).build(),
                HttpResponse.BodyHandlers.ofString());

        String token = tokenRes.body().split("\"access_token\":\"")[1].split("\"")[0];

        HttpResponse<String> res = CLIENT.send(HttpRequest.newBuilder()
                .uri(URI.create(BASE + "/enterprise/risk?keyword=" +
                        java.net.URLEncoder.encode("海南禾泰水产有限公司", "UTF-8")))
                .header("Authorization", "Bearer " + token)
                .GET().build(), HttpResponse.BodyHandlers.ofString());

        System.out.println(res.body());
    }
}