管理API对接文档

最近更新时间：

接口说明

说明
  • 使用个转企审批时，制度入口下，有员工个人支付费用，支付完成后，可以发起接口申请和审批结果同步。
  • 使用接口需要联系对应的业务同学开通对应的权限。

基本信息

HTTP URL

river/Approval/pass

HTTP Method

POST

权限要求


请求头

参数名称

参数值

Content-Type

application/json

请求参数

字段名

字段说明

字段类型

必填

备注

client_id

申请应用时分配的AppKey

string

Y


access_token

授权后的access token

string

Y


company_id

企业ID

string

Y


timestamp

当前时间戳(精确到秒级)

int

Y


sign

签名

string

Y


object_type

授权对象

int

Y

枚举值数字：
1：订单
2：审批单

object_id

授权id

int

N

object_type=1：订单，授权id为滴滴侧订单号order_id
object_type=2：审批单，授权id为滴滴侧申请单号（approval_id）

object_approval_type

审批类型

int

N

审批类型与可使用授权对象关系具体参见附录，机酒火相关审批无需传审批类型，需传curr_action_id

枚举值数字：
3: 行后审批
4：个转企类型
21：企业级事前审批单用车

is_pass

审批类型

int

Y

枚举值数字：
1：通过
2：拒绝

curr_action_id

当前审批操作 ID

string

N

未在object_approval_type列举的审批单类型，可以只使用curr_action_id处理审批结果
curr_action_id，需要从审批事件回调中获取

cur_approver

当前审批人

string

N

举例：“{"type":"phone","value":"11100077098"}"


cur_approver

字段名

字段说明

字段类型

必填

备注

type

人员类型主键

string

Y

英文枚举：employee_number ，email  ，phone

value

人员主键对应的值

string

Y


请求示例

curl --location 'https://api.es.xiaojukeji.com/pre-release-04/river/Approval/pass' \
--header 'Content-Type: application/json' \
--data '{
    "access_token": "dc07616c0a793f8fb800121e8e40e52c32d21cc9",
    "object_approval_type": 21,
    "company_id": "1125938477133618",
    "object_type": 2,
    "sign": "cc660079a2c32ec76204e7a6285154c5",
    "is_pass": 1,
    "cur_approver": "{\"type\":\"phone\",\"value\":\"11100077098\"}",
    "object_id": 1125940359598300,
    "client_id": "cda5ca896642adf824149707b3dd8f11_test",
    "sign_key": "14231EBB2f148BA2a564",
    "timestamp": "1725270231856"
}'

响应参数

字段名

字段说明

字段类型

备注

errno

错误编码

string

数字 0 表示成功，非0 表示失败

errmsg

错误信息

string

errno=0时为常量"SUCCESS"，errno!=0时为错误信息

data

数据

object

展示approval_id对应的值，报错时展示对应的明细信息

approval_id

审批单号

string



响应示例

正常示例

{
    "errno": 0,
    "errmsg": "SUCCESS",
    "data": {        
        "approval_id": "1125940359756957"       
    },
    "request_id": "b7tL\/EnaLhruDTmG6He\/eERWsDVnhvc2wF7J\/BpLDgMxfjCPaeaW0R\/0ewonNQaO"
}

异常示例

{
    "errno": 50800,
    "errmsg": "is_pass只能为1",
    "data": {
        "error_info_list": [
            {
                "err_no": -12,
                "err_msg": "is_pass只能为1"
            }
        ]
    },
    "request_id": "+xvHWIzBGl16BgAlsY0oT0JmUFVEOCxzmZvfjLWDSC5IAYl62HH9w+4RpYMNjVVV"
}


错误码

通用错误解决方案

外层错误码

错误码

说明

0

成功

50800

下游传递的具体错误说明

50503

审批单通过失败，请重试


data内错误明细

错误码

说明

-12

参数错误

101

获取用户信息失败

1004

申请表提交失败

1201

审批表提交失败

1308

对象类型错误（object_type 不存在）

1309

审批类型错误（object_type和object_approval_type映射不对）

1601

公司未开启openapi因公审批

1602

订单不支持API接口个转企

10001

备注包含敏感词


附录

审批类型与可使用授权对象关系

object_approval_type审批类型

curr_action_id

object_type 授权对象

is_pass 审批类型

cur_approver 当前审批人

3 行后审批

不需要提供

1 订单

1：通过
2：拒绝

支持

4 个转企类型

不需要提供

1 订单

1：通过

不支持

21 企业级事前审批单用车

不需要提供

2 审批单
需要白名单

1：通过
2：拒绝

支持

机票预订审批，酒店预订审批，机票改签审批，国际机票预订审批，国际酒店预订审批，国际机票改签审批，火车票预订审批，火车票改签审批，机票退票费用归属审批

提供

2 审批单

1：通过
2：拒绝

支持


版本记录

日期

更新人

更新内容

上线时间

2024.08.30

陈继诗

新建文档

2024.09.05

2024.11.04

陈继诗

object_approval_type增加枚举 21; object_type增加枚举2 ; is_pass增加 枚举 2 ; 增加cur_approver


2025.08.06

唐腾飞

1、object_approval_type 设置为非必填
2、新增当前审批操作ID字段：curr_action_id


2026.04.21

杨露佳

object_approval_type增加枚举 3 行后审批

2026.04.21