obsidian/子兰工作/钉钉宜搭 API 对接参数.md

钉钉宜搭 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

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

返回示例：

{
  "expireIn": 7200,
  "accessToken": "8a801386..."
}

搜索表单数据

新版 API（需专业版）：

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 后再处理