首页›文档中心

5 分钟接入指南

本文档帮助您按当前网站流程完成首次接入:注册登录、实名认证、领取免费额度、在线调试,再进入正式调用。

准备工作

  • 注册账号:使用手机号和短信验证码登录/注册。
  • 完成实名:个人/企业实名认证后才可使用在线调试和免费额度。
  • 免费额度:实名认证完成后赠送 1,000 次 API 免费调用总量,不是每个接口各 1,000 次。
  • 接口价格:当前数据市场接口统一为 0.05 元/次。
  • 充值开通:充值中心提交余额充值订单,后台确认后开通正式调用。

推荐接入流程

  1. 在官网点击「登录/注册」,输入手机号与验证码。
  2. 进入 实名认证,选择个人或企业认证并提交资料。
  3. 认证完成后进入 数据市场,打开接口详情并使用「在线调试」。
  4. 免费额度用完或需要正式业务接入时,前往 充值中心 提交订单。
  5. 后台完成接口授权后,客户可在用户后台查看接口额度、余额、调用日志和费用明细。

在线调试

以「工商信息」接口为例:

JINGHAI_API_BASE="${JINGHAI_API_BASE:-https://www.kqdaas.com}"
COMPANY="成都乐云互动网络技术有限公司"
QUERY_TYPE="1"
ENDPOINT="/DataService/api/v3/company/detail/${COMPANY}?queryType=${QUERY_TYPE}"
 
echo "${JINGHAI_API_BASE}${ENDPOINT}"

常用参数:

参数说明
id企业 ID、企业名称或统一社会信用代码
queryType不传时默认按企业 ID;传 1 表示企业名称,传 2 表示统一社会信用代码

正式调用说明

正式生产调用需要先由后台开通接口授权。开通后用户后台会展示 AppID 和 API Key,客户服务端可直接请求同域名下的 /DataService/api/v3/... 网关路径。

CLI 示例:

JINGHAI_API_BASE="${JINGHAI_API_BASE:-https://www.kqdaas.com}"
JINGHAI_APP_ID="${JINGHAI_APP_ID:-YOUR_APP_ID}"
JINGHAI_API_KEY="${JINGHAI_API_KEY:-YOUR_API_KEY}"
COMPANY="成都乐云互动网络技术有限公司"
ENDPOINT="/DataService/api/v3/company/detail/${COMPANY}?queryType=1"
 
curl --fail-with-body --location --request GET "${JINGHAI_API_BASE}${ENDPOINT}" \
  -H "X-Jinghai-App-Id: ${JINGHAI_APP_ID}" \
  -H "X-Jinghai-Api-Key: ${JINGHAI_API_KEY}" \
  -H "Accept: application/json"

平台会按客户账号完成鉴权、调用日志记录、免费额度扣减和正式余额扣费。

给 AI 代理的操作指令

把下面这段交给 Cursor、Claude Code、Codex 或其他命令行代理即可:

读取环境变量 JINGHAI_API_BASE、JINGHAI_APP_ID、JINGHAI_API_KEY。
把 COMPANY 替换为要查询的企业名称、企业 ID 或统一社会信用代码。
执行 curl --fail-with-body --location 请求 /DataService/api/v3/company/detail/${COMPANY}?queryType=1。
解析 JSON 响应中的 errcode/status/code；200 或 success=true 视为成功。
输出 data 字段，记录 requestId、耗时和接口路径，不要在日志中打印 API Key。

响应格式

接口统一返回 JSON,结构通常如下:

{
  "status": 200,
  "message": "Success",
  "data": {
    "companyName": "上海示例科技有限公司",
    "juridicalPerson": "张三",
    "businessStatus": "存续"
  },
  "success": true
}
  • status / errcode / code:业务状态码,200 表示成功。
  • message / errmsg / msg:状态描述。
  • data:接口业务数据,结构因接口而异。
  • success:布尔值,表示业务是否成功。

下一步