认证与鉴权
鲸海数据当前分为两类调用场景:官网在线调试和正式生产接入。两类场景的鉴权方式不同,请按实际使用阶段选择。
官网在线调试
使用条件:
- 已使用手机号登录/注册。
- 已完成个人或企业实名认证。
- 账户仍有免费额度或已开通正式接口额度。
免费额度规则
| 规则 | 当前设置 |
|---|---|
| 领取条件 | 完成实名认证 |
| 免费总量 | 1,000 次 API 调用总量 |
| 适用范围 | 数据市场在线调试与接入验证 |
| 用完后 | 需要充值、购买套餐或联系商务开通接口 |
免费额度是账户总量,不是每个接口单独赠送。
正式生产接入
正式接入需要后台开通接口授权。开通后客户可直接请求鲸海数据网关路径,例如:
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"开通后平台会为客户配置:
- 调用凭证:AppID / API Key。
- 可调用接口范围。
- 余额预付费或授信后付费计费模式。
- 单接口价格,当前统一为 0.05 元/次。
- 调用次数、日额度、到期时间和授权状态。
- 调用日志、余额和费用明细查询。
CLI / AI 代理约定
面向命令行或 AI 代理接入时,建议统一使用以下约定:
1. 凭证只从环境变量读取: JINGHAI_APP_ID、JINGHAI_API_KEY。
2. 网关域名从 JINGHAI_API_BASE 读取,默认 https://www.kqdaas.com。
3. 每次请求都带 X-Jinghai-App-Id、X-Jinghai-Api-Key、Accept: application/json。
4. 请求路径使用 ENDPOINT 变量表达,便于 AI 代理替换企业名称、分页和筛选参数。
5. 响应成功判断兼容 errcode/status/code=200 或 success=true。
6. 日志记录接口路径、状态码、耗时和 requestId,不要记录 API Key。IP 白名单
如客户需要更高安全性,正式接入时可配置服务器 IP 白名单。建议提供:
- 生产服务器公网出口 IP。
- 测试服务器公网出口 IP。
- 是否存在多出口、NAT 网关或负载均衡出口。
非白名单 IP 的请求可能会被拒绝。上线切换前,应先确认测试白名单和生产白名单都已配置。
鉴权失败常见原因
- 未携带
X-Jinghai-App-Id或X-Jinghai-Api-Key。 - 未完成实名认证。
- 免费额度已用完。
- 正式接口尚未授权。
- 账户余额不足或授权次数不足。
- 应用被冻结、授权过期或 IP 不在白名单内。
- 请求参数错误导致接口返回异常。
如有问题,请前往 常见问题 或联系客服 15708456260。