# 钉钉宜搭 API 对接参数

> 更新时间：2026-07-12
> 状态：免费版不支持 OpenAPI，暂无法通过 API 对接

---

## 版本限制

| 版本 | Open API | 说明 |
| --- | --- | --- |
| 免费版 | ❌ 不支持 | 当前版本 |
| 轻享版 | ❌ 不支持 | — |
| 专业版 | ✅ 支持 | 需升级 |
| 专属版 | ✅ 支持 | — |

官方文档：<https://docs.aliwork.com/docs/yida_support/lbtl0t/rrwdug>

旧版 epaas 网关 (`yida_vpc`) 跑在阿里内部 `s-api.alibaba-inc.com`，不对外开放。

---

## 钉钉应用参数

| 参数 | 值 |
| --- | --- |
| App ID | `fd9b7913-05d9-415c-bd8c-53bbe7a5294d` |
| 企业内部应用 AgentId | `4770352152` |
| Client ID (AppKey) | `dingb8psuvfroz3zt1h3` |
| Client Secret (AppSecret) | `aEIvMtlLsVKP_UmH2MFHIkFkjQ2LkomO_BQ4_OSDzTQ78n69eucGW5MoiEI0xfS-` |
| CorpId | `dingda64f46a2cad01daf5bf40eda33b7ba0` |

---

## 宜搭应用参数

| 参数 | 值 |
| --- | --- |
| Corp ID | `dingda64f46a2cad01daf5bf40eda33b7ba0` |
| 应用编码 (appType) | `APP_UBL5OPKBUPINVFSPD25Z` |
| 应用密钥 (systemToken) | `74D661A14FC7T2BYNZ5378IRZB4E3IHYFEHRMX9L` |
| 当前登录人 ID | `0363285633950235` |

---

## 表单清单

| 页面名称 | 类型 | 表单编码 (formUuid) |
| --- | --- | --- |
| 客户信息表 | 表单 | `FORM-6E937BB6585247A28F8BB412CEE2B1C8LAKX` |
| 客管数据 | 表单 | `FORM-1444E8ABDE2F44BA98F439DDA5EE4EB56C6V` |
| 设计数据 | 表单 | `FORM-9F02E91465CD40DEA723C81F17B56BC3ETQB` |
| 项目数据 | 表单 | `FORM-ACFC84A6B6974E3388DAD94EDD39CDF5IP11` |
| 交付数据 | 表单 | `FORM-3820E9ED75A9427FB5235092BFCD5738CV7N` |

---

## API 调用方式（升级到专业版后可用）

### 获取 access_token

```bash
curl -s https://api.dingtalk.com/v1.0/oauth2/accessToken \
  -H "Content-Type: application/json" \
  -d '{
    "appKey": "dingb8psuvfroz3zt1h3",
    "appSecret": "aEIvMtlLsVKP_UmH2MFHIkFkjQ2LkomO_BQ4_OSDzTQ78n69eucGW5MoiEI0xfS-"
  }'
```

返回示例：
```json
{
  "expireIn": 7200,
  "accessToken": "8a801386..."
}
```

### 搜索表单数据

**新版 API（需专业版）：**

```bash
curl -s -X POST "https://api.dingtalk.com/v1.0/yida/forms/instances/search" \
  -H "x-acs-dingtalk-access-token: <access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "appType": "APP_UBL5OPKBUPINVFSPD25Z",
    "systemToken": "74D661A14FC7T2BYNZ5378IRZB4E3IHYFEHRMX9L",
    "userId": "0363285633950235",
    "formUuid": "FORM-6E937BB6585247A28F8BB412CEE2B1C8LAKX",
    "searchFieldJson": "{}",
    "currentPage": 1,
    "pageSize": 50
  }'
```

**免费版报错：** `异常:您组织使用的宜搭「免费版」，暂不支持使用「openApi」`

---

## 其他宜搭 API 接口（专业版可用）

| 接口 | 路径 |
| --- | --- |
| 搜索表单实例 | `POST v1.0/yida/forms/instances/search` |
| 获取单条数据 | `GET v1.0/yida/forms/instances/{instanceId}` |
| 新增表单数据 | `POST v1.0/yida/forms/instances` |
| 更新表单数据 | `PUT v1.0/yida/forms/instances` |
| 删除表单数据 | `DELETE v1.0/yida/forms/instances/{instanceId}` |

---

## 免费版替代方案

在无法调用 OpenAPI 的情况下，可考虑：

1. **宜搭 JS 动作面板**：在表单里写 JS，主动推送数据到外部服务器
2. **Webhook/连接器**：宜搭免费版支持配置 Webhook 通知
3. **手动导出**：从宜搭后台导出 Excel 后再处理