企业微信——智能表格学习

智能表格

应用限制条件

获取 token

https://developer.work.weixin.qq.com/document/10013#%E5%BC%80%E5%8F%91%E6%AD%A5%E9%AA%A4

开发步骤

你可以通过以下步骤，使用access_token来访问企业微信的接口。需要注意的是，所有的接口需使用Https协议、Json数据格式、UTF8编码。
注：查看接口说明中，参数中标注大写的单词，表示为需要替换的变量。

第一步：获取secret

• 通讯录管理、外部联系人管理、审批、打卡等基础应用是企业微信默认集成的应用，可以直接开启并拿到secret。参考上文secret的介绍。
• 如果企业需要开发自定义的应用，进入“企业应用”页面，在“自建应用”栏点击“创建应用”，完成应用的添加和配置，详细步骤请参见应用概述。

第二步：开启接收消息模式

开启接收消息模式并不是必须步骤，但是如果在你的企业应用中需要用到如下功能时需提前开启接收消息模式。

• 获取企业成员的地理位置信息
• 动态调整企业应用的信息
• 获取企业成员点击事件类型的应用菜单行为
• 获取企业成员通过应用给企业后台发送的消息

关于如何开启接收消息模式，请阅读接收消息配置章节。

第三步：获取access_token

**请求方式：**GET（HTTPS）
**请求URL：**https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRET
注：此处标注大写的单词ID和SECRET，为需要替换的变量，根据实际获取值更新。其它接口也采用相同的标注，不再说明。

若企业安装了第三方应用，该服务商可通过“获取企业access_token”获得此调用凭证。

参数说明：

参数	必须	说明
corpid	是	企业ID
corpsecret	是	应用的凭证密钥

权限说明：

每个应用有独立的secret，所以每个应用的access_token应该分开来获取

返回结果：

{
   
   "errcode":0,
   "errmsg":"",
   "access_token": "accesstoken000001",
   "expires_in": 7200
}

参数	说明
access_token	获取到的凭证,最长为512字节
expires_in	凭证的有效时间（秒）

api

创建文件

https://developer.work.weixin.qq.com/document/path/97470

请求方式：POST（HTTPS）
请求地址: https://qyapi.weixin.qq.com/cgi-bin/wedoc/create_doc?access_token=ACCESS_TOKEN

请求包体

{
   
	"spaceid": "SPACEID",
	"fatherid": "FATHERID",
	"doc_type": 3,
	"doc_name": "DOC_NAME",
	"admin_users": ["USERID1", "USERID2", "USERID3"]
}

参数说明

参数	类型	是否必须	说明
spaceid	string	否	空间spaceid。若指定spaceid，则fatherid也要同时指定
fatherid	string	否	父目录fileid, 在根目录时为空间spaceid
doc_type	uint32	是	文档类型, 3:文档 4:表格 10:智能表格
doc_name	string	是	文档名字（注意：文件名最多填255个字符, 超过255个字符会被截断）
admin_users	string[]	否	文档管理员userid

说明：

新增文档包含一个默认Sheet 名：q979lj

文档查询

https://qyapi.weixin.qq.com/cgi-bin/wedoc/get_doc_base_info

{
   
	"docid": "dc1g39eaMOXvG5KOR6VDeI0UJ6xcFqv2hqoPxy4AiKXS5NiKwibbKcNcAlzKega0-Mb26JGiuUnG-n3X1g1sIEyA"
}

新增sheet

https://qyapi.weixin.qq.com/cgi-bin/wedoc/smartsheet/add_sheet

{
	"docid": "dcNCrxIDPxTtI8QzxxxDA0zKIPg",
	"properties": {
		"title": "智能表111"
	}
}

说明：新增 sheet 包含一个默认字段：fabcde

查询sheet

论坛问题：https://developer.work.weixin.qq.com/community/question/detail?content_id=16671111556455089080

https://developer.work.weixin.qq.com/document/path/99911

{

“docid”: “dc1g39eaMOXvG5KOR6VDeI0UJ6xcFqv2hqoPxy4AiKXS5NiKwibbKcNcAlzKega0-Mb26JGiuUnG-n3X1g1sIEyA”

}

重命名sheet

https://developer.work.weixin.qq.com/document/path/100215

查看字段

https://qyapi.weixin.qq.com/cgi-bin/wedoc/smartsheet/get_fields

{
   
	"docid": "dc1g39eaMOXvG5KOR6VDeI0UJ6xcFqv2hqoPxy4AiKXS5NiKwibbKcNcAlzKega0-Mb26JGiuUnG-n3X1g1sIEyA",
	"sheet_id": "q979lj",
	"offset":