文档/快速上手

开发者快速上手

从创建 API Key 到发出第一条企业查询请求，只需几分钟即可完成 TurningAPI 接入。下面以企业基础信息接口为例，演示测试环境与生产环境的对接方式。

创建并导出 API 密钥

访问控制台创建密钥。完成后，在您的开发环境终端执行以下命令：

# 导出环境变量到当前会话

export TURNING_API_KEY="your_api_key_here"

安全提示

所有 API 请求都必须在 HTTP 请求头中包含您的 API Key 进行认证：Authorization: Bearer YOUR_API_KEY。请勿在客户端代码中暴露您的 API Key，建议使用环境变量或安全的密钥管理服务。

选择环境并发起第一条请求

当前示例接口：POST /v1/enterprise/identity/base-infos。测试环境可直接走公网地址，生产环境请以当前前端配置中的生产公网地址为准。

$# 浏览器或 Node 18+ 可直接使用 fetch

const response = await fetch("http://124.222.117.104:9101/api/v1/enterprise/identity/base-infos", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.TURNING_API_KEY,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    cname: "厦门益东智能科技有限公司",
    creditCode: ""
  })
});

const data = await response.json();
console.log(data);

响应示例

{
  "code": "200",
  "message": "成功",
  "data": {
    "attributes": {},
    "insights": {},
    "analytics": {},
    "summary": {
      "companyOverview": "企业基础信息查询成功"
    }
  },
  "timestamp": 1777600000000
}

错误处理

TurningAPI 使用标准的 HTTP 响应代码来指示 API 请求的成功或失败。

HTTP 状态码	错误码	描述
400	40001	请求参数格式错误或缺失
401	40101	API Key 无效或未提供
403	40301	无权访问该 API
404	40401	未找到匹配的记录
429	42901	请求频率超限
500	50001	服务内部错误

速率限制

为确保服务的稳定性，我们对 API 调用频率进行了限制。

标准套餐

100 请求/分钟

专业套餐

1000 请求/分钟

企业套餐

无限制（专属集群）

核心能力解析

企业基础信息查询

适合客户准入、供应商尽调、存量企业核验等场景。建议优先传 `creditCode`，也可仅传 `cname`。

const payload = {
  cname: "厦门益东智能科技有限公司",
  creditCode: ""
};

const response = await fetch("http://124.222.117.104:9101/api/v1/enterprise/identity/base-infos", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify(payload)
});

批量企业更新状态

公开数据能力，可直接调用。适合把企业批量标记为待更新状态，便于后续统一刷新。

curl -X POST http://124.222.117.104:9101/api/v1/enterprise/operations/refresh-statuses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "enterpriseNames": ["厦门益东智能科技有限公司"],
    "creditCodes": [],
    "updateType": "NORMAL"
  }'