|
@@ -0,0 +1,120 @@
|
|
|
|
|
+# 钉钉宜搭 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 后再处理
|
