← 返回解决方案列表

🔌 API化升级服务

企业级API中台

📊 API服务概览

🏢 企业信息查询

工商注册、经营状态、股东信息、变更记录等企业全维度数据查询接口

GETPOST

⚖️ 法务智能服务

合同审查、法律咨询、风险评估、案件检索等AI法务能力接口

POSTWS

💰 财税计算引擎

增值税计算、企业所得税、个税测算、发票查验等财税核心接口

GETPOST

🏠 房产数据服务

房源信息、价格评估、区域分析、交易流程等房产数据接口

GET

🎓 教育培训接口

课程管理、学员分析、智能排课、成绩评估等教育场景接口

GETPOSTPUT

🏥 健康管理接口

健康档案、预约挂号、体检报告、用药提醒等健康服务接口

GETPOST

🐾 宠物服务接口

宠物档案、疫苗提醒、医院预约、寄养管理等宠物场景接口

GETPOST

🏪 门店运营接口

库存管理、订单处理、会员体系、数据看板等门店运营接口

GETPOSTPUTDELETE

📢 营销自动化接口

活动创建、优惠券发放、用户分群、效果追踪等营销能力接口

POSTWS

📖 接口文档

企业信息

法务智能

财税计算

健康管理

门店运营

营销自动化

GET /api/v2/enterprise/info

查询企业工商注册信息、经营状态、法定代表人等核心数据

请求参数

参数名	类型	必填	说明
keyword	string	必填	企业名称或统一社会信用代码
fields	string	可选	返回字段筛选，逗号分隔（默认全部）
page	integer	可选	页码（默认1）
page_size	integer	可选	每页条数（默认20，最大100）

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "company_name": "深圳市某某科技有限公司",
    "credit_code": "91440300MA5XXXXX",
    "legal_person": "张三",
    "registered_capital": "100万人民币",
    "status": "在营",
    "established_date": "2020-03-15",
    "business_scope": "软件开发、信息技术咨询..."
  }
}

POST /api/v2/enterprise/search

高级企业搜索，支持多维度筛选和模糊匹配

请求参数

参数名	类型	必填	说明
keyword	string	必填	搜索关键词
province	string	可选	省份筛选
industry	string	可选	行业分类
capital_min	number	可选	注册资本下限（万元）
capital_max	number	可选	注册资本上限（万元）
status	string	可选	经营状态（在营/注销/吊销）

响应示例

{
  "code": 200,
  "data": {
    "total": 156,
    "items": [
      {"company_name": "...", "credit_code": "...", "status": "在营"}
    ]
  }
}

POST /api/v2/legal/contract-review

AI智能合同审查，自动识别风险条款并提供修改建议

请求参数

参数名	类型	必填	说明
contract_text	string	必填	合同全文内容
contract_type	string	可选	合同类型（劳动/租赁/买卖/服务）
focus_areas	array	可选	重点审查领域

响应示例

{
  "code": 200,
  "data": {
    "risk_level": "medium",
    "risk_items": [
      {"clause": "第5条 违约责任", "risk": "违约金比例过高", "suggestion": "建议调整为合同金额的10%-20%"}
    ],
    "compliance_score": 72
  }
}

POST /api/v2/legal/consult

AI法律咨询，提供专业法律意见和法规引用

请求参数

参数名	类型	必填	说明
question	string	必填	法律咨询问题
domain	string	可选	法律领域（民事/商事/劳动/知产）
jurisdiction	string	可选	司法管辖区（默认中国大陆）

POST /api/v2/finance/tax-calculate

智能税费计算，支持增值税、企业所得税、个税等多税种

请求参数

参数名	类型	必填	说明
tax_type	string	必填	税种（vat/cit/iit）
revenue	number	必填	收入金额
deductions	number	可选	可抵扣金额
taxpayer_type	string	可选	纳税人类型（general/small）

响应示例

{
  "code": 200,
  "data": {
    "tax_amount": 12500.00,
    "effective_rate": "2.5%",
    "breakdown": {
      "output_tax": 26000.00,
      "input_tax": 13500.00,
      "net_tax": 12500.00
    }
  }
}

GET /api/v2/finance/invoice-verify

发票真伪查验，支持增值税专票、普票、电子发票

请求参数

参数名	类型	必填	说明
invoice_code	string	必填	发票代码
invoice_no	string	必填	发票号码
amount	string	必填	开票金额（不含税）
date	string	可选	开票日期（YYYY-MM-DD）

GET /api/v2/health/records

查询用户健康档案，包含体检记录、用药史、过敏信息

请求参数

参数名	类型	必填	说明
user_id	string	必填	用户唯一标识
record_type	string	可选	记录类型（checkup/medication/allergy）
date_from	string	可选	起始日期
date_to	string	可选	截止日期

POST /api/v2/health/appointment

在线预约挂号，支持湾区三甲医院资源

请求参数

参数名	类型	必填	说明
hospital_id	string	必填	医院ID
department	string	必填	科室
doctor_id	string	可选	指定医生
appointment_date	string	必填	预约日期
time_slot	string	必填	时段（am/pm）

GET /api/v2/store/inventory

门店库存查询，支持多仓库、多SKU批量查询

请求参数

参数名	类型	必填	说明
store_id	string	必填	门店ID
sku_list	array	可选	SKU列表（不传则返回全量）
status	string	可选	库存状态（in_stock/low/out）

POST /api/v2/store/order

创建门店订单，支持堂食/外卖/自提多种场景

请求参数

参数名	类型	必填	说明
store_id	string	必填	门店ID
order_type	string	必填	订单类型（dine_in/takeout/pickup）
items	array	必填	商品列表[{sku_id,quantity,price}]
member_id	string	可选	会员ID

POST /api/v2/marketing/campaign

创建营销活动，支持满减/折扣/赠品/抽奖等多种玩法

请求参数

参数名	类型	必填	说明
name	string	必填	活动名称
type	string	必填	活动类型（discount/gift/lottery）
start_time	string	必填	开始时间
end_time	string	必填	结束时间
rules	object	必填	活动规则配置
target_users	array	可选	目标用户分群

WS /api/v2/marketing/realtime-stats

营销数据实时推送，活动效果、转化率、ROI实时监控

WebSocket长连接，连接后自动推送活动实时数据

推送数据格式

{
  "event": "stats_update",
  "data": {
    "campaign_id": "cmp_20260625_001",
    "impressions": 12580,
    "clicks": 892,
    "conversions": 156,
    "roi": 3.2
  }
}

🔄 接入流程

注册开发者账号

填写企业信息，提交资质审核，获取开发者ID

→

创建应用

在控制台创建应用，获取AppKey和AppSecret密钥对

→

配置权限

按需开通API接口权限，设置IP白名单和调用频率

→

开发调试

使用SDK或直接调用接口，沙箱环境免费调试

→

上线运行

通过审核后切换生产环境，正式调用API服务

快速接入代码示例

Python

Node.js

Java

cURL

import requests
import hashlib
import time

API_BASE = "https://api.duncreator.com/v2"
APP_KEY = "your_app_key"
APP_SECRET = "your_app_secret"

def call_api(method, path, params=None):
    timestamp = str(int(time.time()))
    sign_str = APP_KEY + timestamp + APP_SECRET
    sign = hashlib.md5(sign_str.encode()).hexdigest()
    headers = {
        "X-App-Key": APP_KEY,
        "X-Timestamp": timestamp,
        "X-Sign": sign,
        "Content-Type": "application/json"
    }
    url = API_BASE + path
    if method == "GET":
        resp = requests.get(url, params=params, headers=headers)
    else:
        resp = requests.post(url, json=params, headers=headers)
    return resp.json()

# 查询企业信息
result = call_api("GET", "/enterprise/info", {"keyword": "墩墩科技"})
print(result)

const axios = require('axios');
const crypto = require('crypto');

const API_BASE = 'https://api.duncreator.com/v2';
const APP_KEY = 'your_app_key';
const APP_SECRET = 'your_app_secret';

async function callApi(method, path, params = {}) {
  const timestamp = Math.floor(Date.now() / 1000).toString();
  const signStr = APP_KEY + timestamp + APP_SECRET;
  const sign = crypto.createHash('md5').update(signStr).digest('hex');
  const headers = {
    'X-App-Key': APP_KEY,
    'X-Timestamp': timestamp,
    'X-Sign': sign,
    'Content-Type': 'application/json'
  };
  const config = { method, url: API_BASE + path, headers };
  if (method === 'GET') config.params = params;
  else config.data = params;
  const resp = await axios(config);
  return resp.data;
}

// 查询企业信息
callApi('GET', '/enterprise/info', { keyword: '墩墩科技' })
  .then(data => );

import java.net.http.*;
import java.security.*;

public class DunCreatorApi {
    static final String API_BASE = "https://api.duncreator.com/v2";
    static final String APP_KEY = "your_app_key";
    static final String APP_SECRET = "your_app_secret";

    public static String generateSign(String timestamp) throws Exception {
        String signStr = APP_KEY + timestamp + APP_SECRET;
        MessageDigest md = MessageDigest.getInstance("MD5");
        byte[] hash = md.digest(signStr.getBytes());
        StringBuilder sb = new StringBuilder();
        for (byte b : hash) sb.append(String.format("%02x", b));
        return sb.toString();
    }
}

# 设置变量
API_BASE="https://api.duncreator.com/v2"
APP_KEY="your_app_key"
APP_SECRET="your_app_secret"
TIMESTAMP=$(date +%s)
SIGN=$(echo -n "${APP_KEY}${TIMESTAMP}${APP_SECRET}" | md5sum | cut -d' ' -f1)

# 查询企业信息
curl -X GET "${API_BASE}/enterprise/info?keyword=墩墩科技" \
  -H "X-App-Key: ${APP_KEY}" \
  -H "X-Timestamp: ${TIMESTAMP}" \
  -H "X-Sign: ${SIGN}"

🔐 权限配置

🔑 身份认证机制

墩墩API采用AppKey + 签名认证机制，每次请求需携带以下Header：

Header	类型	说明
X-App-Key	string	应用唯一标识，在控制台创建应用后获取
X-Timestamp	integer	请求时间戳（秒级），允许±300秒误差
X-Sign	string	请求签名，MD5(AppKey+Timestamp+AppSecret)

客户端发起请求

→

携带签名Header

→

网关验证签名

→

检查接口权限

→

转发至后端

🛡️ 权限等级

API接口按敏感度分为三个权限等级，需逐级申请：

等级	说明	申请条件	频率限制
L1 基础	公开信息查询、基础计算	注册即可使用	1000次/分钟
L2 进阶	业务数据操作、AI分析	企业认证+签署协议	500次/分钟
L3 核心	敏感数据、批量操作、实时推送	专项审核+安全评估	100次/分钟

🌐 IP白名单

为保障接口安全，建议配置服务器IP白名单。未配置时，L2及以上权限接口将拒绝访问。

配置路径：控制台 → 应用管理 → 安全设置 → IP白名单

⚡ 频率限制策略

所有API接口均设有频率限制，超出限制将返回HTTP 429状态码：

限制类型	默认值	超出处理
每分钟请求	按权限等级	返回429，Retry-After头标明等待秒数
每日总量	按套餐额度	返回429，次日自动恢复
并发连接	10个	排队等待，超时返回503

🏢 对接案例

🍜

蜀味轩餐饮连锁

门店+营销API

通过接入门店运营API和营销自动化API，实现30家门店库存实时同步、会员体系打通、营销活动一键下发，运营效率提升200%

门店接入

↑200%

运营效率

↑45%

会员转化

3天

对接周期

⚖️

湾区法务咨询集团

法务+企业信息API

接入法务智能API和企业信息查询API，实现客户企业背景自动尽调、合同AI审查、风险实时预警，律师效率提升150%

500+

月审查量

↑150%

审查效率

98%

风险识别率

5天

对接周期

🏥

深圳康健医疗集团

健康管理API

接入健康管理API，实现5家诊所患者档案互通、预约挂号线上化、体检报告智能解读，患者满意度提升35%

诊所接入

↑35%

满意度

↓60%

候诊时间

7天

对接周期

🏠

湾区安居房产平台

房产+企业信息API

接入房产数据API和企业信息API，实现房源智能匹配、中介资质自动核验、交易流程全链路数字化，成交率提升80%

↑80%

成交率

1200+

月活用户

↓40%

交易周期

4天

对接周期

💎 方案定价

体验版

适合个人开发者和小团队试用

免费/月

L1基础接口权限
1000次/日调用额度
沙箱环境调试
社区技术支持
基础数据报表

专业版

适合中小企业业务对接

¥2,999/月

L1+L2接口权限
50,000次/日调用额度
生产环境接入
专属技术顾问
实时监控告警
IP白名单配置

企业版

适合大型企业定制化需求

定制/年

全等级接口权限
无限调用额度
私有化部署可选
7×24专属服务
SLA 99.9%保障
定制接口开发
数据安全审计

❓ 常见问题

API调用失败如何排查？▼

请按以下步骤排查：1）检查AppKey和签名是否正确；2）确认时间戳在±300秒内；3）查看HTTP状态码和错误信息；4）确认接口权限已开通；5）检查IP白名单配置。如仍无法解决，请联系技术支持。

如何提升API调用频率？▼

可在控制台提交频率提升申请，需提供业务场景说明和预期调用量。专业版用户默认500次/分钟，企业版用户可申请自定义频率。临时峰值需求可联系技术顾问临时调整。

数据安全如何保障？▼

墩墩API采用多重安全措施：1）全链路HTTPS加密传输；2）AppKey+签名双重认证；3）IP白名单限制访问来源；4）敏感数据脱敏处理；5）操作日志全量审计；6）企业版支持私有化部署。

支持哪些开发语言？▼

墩墩API基于标准RESTful协议，支持所有主流开发语言。官方提供Python、Node.js、Java、Go、PHP五种语言的SDK，其他语言可直接使用HTTP请求调用。

沙箱环境和生产环境有什么区别？▼

沙箱环境使用模拟数据，不产生真实业务效果，不消耗调用额度，适合开发调试。生产环境使用真实数据，所有操作均产生实际效果，调用计入套餐额度。建议先在沙箱完成调试再切换生产环境。

🔌 API化升级服务

企业级API中台，一站式接口管理与智能升级

🏢 企业信息查询

⚖️ 法务智能服务

💰 财税计算引擎

🏠 房产数据服务

🎓 教育培训接口

🏥 健康管理接口

🐾 宠物服务接口

🏪 门店运营接口

📢 营销自动化接口

GET /api/v2/enterprise/info

请求参数

响应示例

POST /api/v2/enterprise/search

请求参数

响应示例

POST /api/v2/legal/contract-review

请求参数

响应示例

POST /api/v2/legal/consult

请求参数

POST /api/v2/finance/tax-calculate

请求参数

响应示例

GET /api/v2/finance/invoice-verify

请求参数

GET /api/v2/health/records

请求参数

POST /api/v2/health/appointment

请求参数

GET /api/v2/store/inventory

请求参数

POST /api/v2/store/order

请求参数

POST /api/v2/marketing/campaign

请求参数

WS /api/v2/marketing/realtime-stats

推送数据格式

注册开发者账号

创建应用

配置权限

开发调试

上线运行

快速接入代码示例

🔑 身份认证机制

🛡️ 权限等级

🌐 IP白名单

⚡ 频率限制策略

蜀味轩餐饮连锁

湾区法务咨询集团

深圳康健医疗集团

湾区安居房产平台

体验版

专业版

企业版