Name
QQ::weixin::work::corp
DESCRIPTION
FUNCTION
get_join_qrcode(access_token, size_type);
获取加入企业二维码 最后更新:2019/11/30
SYNOPSIS
https://developer.work.weixin.qq.com/document/path/91714
请求说明:
参数说明:
参数 必须 说明
access_token 是 调用接口凭证
size_type 否 qrcode尺寸类型,1: 171 x 171; 2: 399 x 399; 3: 741 x 741; 4: 2052 x 2052
权限说明:
须拥有通讯录的管理权限,使用通讯录同步的Secret。
RETURN 返回结果:
{
"errcode": 0,
"errmsg": "ok",
"join_qrcode": "https://work.weixin.qq.com/wework_admin/genqrcode?action=join&vcode=3db1fab03118ae2aa1544cb9abe84&r=hb_share_api_mjoin&qr_size=3"
}
RETURN 参数说明:
参数 说明
errcode 出错返回码,为0表示成功,非0表示调用失败
errmsg 对返回码的文本描述内容
join_qrcode 二维码链接,有效期7天
getapprovaldata(access_token, hash);
获取审批数据(旧) 最后更新:2019/11/22 提示:推荐使用新接口“批量获取审批单号”及“获取审批申请详情”,此接口后续将不再维护、逐步下线。
SYNOPSIS
https://developer.work.weixin.qq.com/document/path/91530
请求说明:
通过本接口来获取公司一段时间内的审批记录。一次拉取调用最多拉取100个审批记录,可以通过多次拉取的方式来满足需求,但调用频率不可超过600次/分。
请求包结构体为:
{
"starttime": 1492617600,
"endtime": 1492790400,
"next_spnum": 201704200003
}
参数说明:
参数 必须 说明
access_token 是 调用接口凭证。必须使用审批应用的secret获取,获取方式参考:文档-获取access_token
starttime 是 获取审批记录的开始时间。Unix时间戳
endtime 是 获取审批记录的结束时间。Unix时间戳
next_spnum 否 第一个拉取的审批单号,不填从该时间段的第一个审批单拉取
1. 获取审批记录请求参数endtime需要大于startime, 同时起始时间跨度不要超过30天; 2. 一次请求返回的审批记录上限是100条,超过100条记录请使用next_spnum进行分页拉取。
权限说明:
RETURN 返回结果:
{
"errcode":0,
"errmsg":"ok",
"count":3,
"total":5,
"next_spnum":201704240001,
"data":[
{
"spname":"报销",
"apply_name":"报销测试",
"apply_org":"报销测试企业",
"approval_name":[
"审批人测试"
],
"notify_name":[
"抄送人测试"
],
"sp_status":1,
"sp_num":201704200001,
"mediaids":["WWCISP_G8PYgRaOVHjXWUWFqchpBqqqUpGj0OyR9z6WTwhnMZGCPHxyviVstiv_2fTG8YOJq8L8zJT2T2OvTebANV-2MQ"],
"apply_time":1499153693,
"apply_user_id":"testuser",
"expense":{
"expense_type":1,
"reason":"",
"item":[
{
"expenseitem_type":6,
"time":1492617600,
"sums":9900,
"reason":""
}
]
},
"comm":{
"apply_data":"{\"item-1492610773696\":{\"title\":\"abc\",\"type\":\"text\",\"value\":\"\"}}"
}
},
{
"spname":"请假",
"apply_name":"请假测试",
"apply_org":"请假测试企业",
"approval_name":[
"审批人测试"
],
"notify_name":[
"抄送人测试"
],
"sp_status":1,
"sp_num":201704200004,
"apply_time":1499153693,
"apply_user_id":"testuser",
"leave":{
"timeunit":0,
"leave_type":4,
"start_time":1492099200,
"end_time":1492790400,
"duration":144,
"reason":""
},
"comm":{
"apply_data":"{\"item-1492610773696\":{\"title\":\"abc\",\"type\":\"text\",\"value\":\"\"}}"
}
},
{
"spname":"自定义审批",
"apply_name":"自定义",
"apply_org":"自定义测试企业",
"approval_name":[
"自定义审批人"
],
"notify_name":[
"自定义抄送人"
],
"sp_status":1,
"sp_num":201704240001,
"apply_time":1499153693,
"apply_user_id":"testuser",
"comm":{
"apply_data":"{\"item-1492610773696\":{\"title\":\"abc\",\"type\":\"text\",\"value\":\"\"}}"
}
}
]
}
RETURN 参数说明:
参数 类型 说明
errcode int32 错误码
errmsg string 错误码说明
count 拉取的审批单个数,最大值为100,当total参数大于100时,可运用next_spnum参数进行多次拉取
total 时间段内的总审批单个数
next_spnum 拉取列表的最后一个审批单号
spname 审批名称(请假,报销,自定义审批名称)
apply_name 申请人姓名
apply_org 申请人部门
approval_name 审批人姓名
notify_name 抄送人姓名
sp_status 审批状态:1审批中;2 已通过;3已驳回;4已取消;6通过后撤销;10已支付
sp_num 审批单号
apply_time 审批单提交时间
apply_user_id 审批单提交者的userid
leave 请假类型(只有请假模板审批记录有此数据项)
timeunit 请假时间单位:0半天;1小时
leave_type 请假类型:1年假;2事假;3病假;4调休假;5婚假;6产假;7陪产假;8其他
start_time 请假开始时间,unix时间
end_time 请假结束时间,unix时间
duration 请假时长,单位小时
reason 请假事由
expense 报销类型(只有报销模板的审批记录有此数据项)
expense_type 报销类型:1差旅费;2交通费;3招待费;4其他报销
reason 报销事由
item 报销明细 (历史单据字段,新申请单据不再提供)
expenseitem_type 费用类型:1飞机票;2火车票;3的士费;4住宿费;5餐饮费;6礼品费;7活动费;8通讯费;9补助;10其他 (历史单据字段,新申请单据不再提供)
time 发生时间,unix时间 (历史单据字段,新申请单据不再提供)
sums 费用金额,单位元 (历史单据字段,新申请单据不再提供)
reason 明细事由 (历史单据字段,新申请单据不再提供)
comm 审批模板信息
apply_data 审批申请的单据数据,请参见下方返回数据注解2;
mediaids 审批的附件media_id,可使用media/get获取附件