滴滴企业版

接口说明

说明

用于查询职级的列表信息

基本信息

HTTP URL	/river/Rank/getRanks
HTTP Method	GET
权限要求

请求头

参数名称	参数值
Content-Type	application/json

请求参数

字段名	字段说明	字段类型	必填	备注
client_id	申请应用时分配的AppKey	string	Y
access_token	授权后的access token	string	Y
company_id	公司 ID	string	Y
timestamp	当前时间戳	bigint	Y
offset	数据开始位置	int	Y
length	数据条数	int	Y	最大100条
sign	签名	string	Y

请求示例

curl -X POST -H "content-type:application/json" \
-d '{
      "client_id":"client_id_test",
      "access_token":"access_token_test",
      "timestamp":1583485957,
      "company_id":"12345678980",
      "sign":"019057df472a3224a1408a3043c5e0a6"
     }' \
https://api.es.xiaojukeji.com/river/Rank/getRanks

响应参数

字段名	字段说明	字段类型
errno	0表示成功，非0表示失败	int
errmsg	errno=0时为常量"SUCCESS"，errno!=0时为错误信息	string
data	数据	object

data

字段名	字段说明	字段类型	备注
total	int	职级集合中的条数
records	array	职级数据集合

records

字段名	字段说明	字段类型
data.records.id	string	职级 id，滴滴侧职级ID
data.records.name	string	职级名称
data.records.out_rank_id	string	外部职级ID

响应示例

正常示例

{
    "errno":0,
    "errmsg":"success",
    "data":{
        "total":2,
        "records":[
            {
                "id":"3241893421",
                "name":"didi",
                "out_rank_id":"D1"
            },
            {
                "id":"3241893312",
                "name":"diditest1",
                "out_rank_id":"D2"
            }
        ]
    }
}

异常示例

错误码

通用错误解决方案

4xx 错误
1xxx 错误

版本记录

日期	更新人	更新内容	上线时间
2023.11.14	陈继诗	迁移文档