获取申请单列表

说明

调用本接口查询企业审批单数据，包括审批状态、时间等。
服务地址：https://oapi.dingtalk.com

权限

服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。详情请参考权限申请。

应用类型	是否支持调用	权限申请方式	API Explorer调试
企业内部应用	是	开发者后台申请	调试
第三方企业应用	是	开发者后台申请	调试
第三方个人应用	否	—	—

请求参数

Query 参数

access_token

string

必需

调用服务端接口的授权凭证。企业内部应用可通过调用access_token接口获得。第三方企业应用可通过调用get_corp_token接口获得。

示例值:

dc73axxxx

Body 参数application/json

object

请求对象。

必需

gmt_modified

string

可选

更新时间大于等于此时间的审批单。

page_size

number

可选

每页返回数量，默认10，最多50。

end_time

string

结束时间。

可选

start_time

string

开始时间。

可选

page

number

页数，从1开始。

可选

userid

string

可选

提交审批单的用户的userid。

deptid

string

部门ID。

可选

corpid

string

必需

企业的corpid。

all_apply

boolean

可选

是否包括未报销的申请：false: 未报销的申请单

only_shang_lv_apply

boolean

可选

是否仅包括商旅申请单：true：商旅申请单

示例

{
    "rq": {
        "start_time": "2017-05-01 00:00:00",
        "corpid": "corp1",
        "all_apply": "true",
        "only_shang_lv_apply": "false",
        "end_time": "2017-05-01 00:00:00",
        "deptid": "dept1",
        "page": "1",
        "gmt_modified": "2017-05-01 00:00:00",
        "userid": "user1",
        "page_size": "10"
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

module

array [object {20}]

审批单列表。

可选

number

商旅审批单ID。

可选

apply_show_id

string

商旅审批展示ID。

可选

gmt_create

string

创建时间。

可选

gmt_modified

string

更新时间。

可选

thirdpart_id

string

可选

第三方审批单ID。如果非第三方审批单则为空。

corpid

string

可选

企业的corpid。

userid

string

可选

用户的userid。

deptid

string

用户的部门ID。

可选

corp_name

string

企业名称。

可选

user_name

string

用户名称。

可选

dept_name

string

部门名称。

可选

trip_day

number

出差天数。

可选

trip_cause

string

出差事由。

可选

trip_title

string

申请单标题。

可选

status

number

可选

申请单状态：0：申请 1：同意 2：拒绝 3：转交 4：取消5：修改已同意 6：撤销已同意 7：修改审批中 8：已同意(修改被拒绝) 9：撤销审批中 10：已同意(撤销被拒绝)11：已同意(修改被取消)12：已同意(撤销被取消)

status_desc

string

审批单状态描述。

可选

itinerary_list

array [object {11}]

行程列表。

可选

traveler_list

array [object {2}]

出行人列表。

可选

approver_list

array [object {7}]

审批人列表。

可选

flow_code

string

流程编码。

可选

errmsg

string

返回码。

可选

errcode

number

返回码描述。

可选

success

boolean

操作是否成功。

可选

示例

{
    "module": [
        {
            "id": 0,
            "apply_show_id": "string",
            "gmt_create": "string",
            "gmt_modified": "string",
            "thirdpart_id": "string",
            "corpid": "string",
            "userid": "string",
            "deptid": "string",
            "corp_name": "string",
            "user_name": "string",
            "dept_name": "string",
            "trip_day": 0,
            "trip_cause": "string",
            "trip_title": "string",
            "status": 0,
            "status_desc": "string",
            "itinerary_list": [
                {
                    "trip_way": 0,
                    "itinerary_id": "string",
                    "traffic_type": 0,
                    "dep_city": "string",
                    "arr_city": "string",
                    "cost_center_name": "string",
                    "invoice_name": "string",
                    "dep_date": "string",
                    "arr_date": "string",
                    "project_code": "string",
                    "project_title": "string"
                }
            ],
            "traveler_list": [
                {
                    "userid": "string",
                    "user_name": "string"
                }
            ],
            "approver_list": [
                {
                    "order": 0,
                    "user_name": "string",
                    "userid": "string",
                    "status": 0,
                    "status_desc": "string",
                    "note": "string",
                    "operate_time": "string"
                }
            ],
            "flow_code": "string"
        }
    ],
    "errmsg": "string",
    "errcode": 0,
    "success": true
}

说明#

权限#

请求参数

示例代码

返回响应

说明

权限