企业微信(1) - API概况

文章目录
  1. 1. ♠ 1 功能
  2. 2. ♠ 2 API开发准备及术语
  3. 3. ♠ 3 接口
    1. 3.1. ♠ 3.1 通讯录功能
    2. 3.2. ♠ 3.2 应用功能
    3. 3.3. ♠ 3.3 收发消息
    4. 3.4. ♠ 3.4 素材
    5. 3.5. ♠ 3.5 身份验证
    6. 3.6. ♠ 3.6 OA(办公)数据接口
    7. 3.7. ♠ 3.7 企业支付
    8. 3.8. ♠ 3.8 电子发票
    9. 3.9. ♠ 3.9 第三方应用

1 功能

  • 通讯录功能:
  • 企业应用功能
  • 消息推送功能
  • 身份验证,免密登录功能
  • 移动端SDK
  • 关联已有的,进行数据同步(微信企业号、腾讯企业邮箱、腾讯通RTX)

2 API开发准备及术语

准备

  1. Https协议
  2. Json数据格式
  3. UTF8编码

术语

  • corpid:企业唯一标志
  • userid:每个成员的唯一标志
  • openid:成员在企业下唯一标志
  • 部门id:部门唯一标识
  • tagid:标签唯一标识(成员)
  • secret:密钥(通讯录及应用)
  • access_token:访问权限验证

3 接口

3.1 通讯录功能

成员

  1. 单个成员增删查改,批量删除。
  2. 查看部门下所有成员(可递归)(分略差和详查)。
  3. userid与openid互换
    1. u->o场景:微信支付、微信红包、企业转账。
    2. o->u场景:微信支付、微信红包、企业转账的结果查询。
  4. 二次验证:成员登录 -> 企业验证 -> 成功进入

部门

  1. 单个增删改
  2. 批量查询(查询指定部门及其下的子部门,默认全量架构)

标签

  1. 增删改(单)、查(多)
  2. 标签内成员(查删改)

邀请成员

  1. 批量邀请(发送短信或邮件)。

3.2 应用功能

  1. 查改(单)、查(多)
  2. 改(单):位置、头像、名称、详情、可信域名、url、菜单。
    1. 菜单功能:点击推送、url、扫码推送、(拍照、相册-发图)、位置。
    2. 菜单操作:增删查(单)。
  3. 功能:收发消息、h5页面(Oauth2.0验证)、授权登录。

3.3 收发消息

:文字、图片、视频、文件、图文。

:文字、图文、语音、视频、位置、链接、事件。

  • 事件:关注/取消事件、进入应用、上报位置、异步任务完成、通讯录变更、菜单事件。

3.4 素材

  1. 上传临时素材(3天)
    1. 图片:2MB,JPG、PNG格式。
    2. 语音:2MB,长度小于60s,AMR格式。
    3. 视频:10MB,MP4格式。
    4. 文件:20MB。
  2. 获取上传的临时素材
  3. 临时高清语音

3.5 身份验证

  • 网页授权(OAuth2.0)
  • 扫码授权

3.6 OA(办公)数据接口

  • 打卡规则:查
  • 打卡数据:查
  • 审批数据:查

3.7 企业支付

  • 微信红包:发、查。
  • 企业付款:付、查。
  • 企业收款:收

3.8 电子发票

  1. 查询(单、多)
  2. 改状态(单、多)

3.9 第三方应用


(幽蛰 写于 2018.01.27)