获取单点登录链接

地址URL

https://api.es.xiaojukeji.com/river/Login/getLoginEncryptStr

返回数据格式

JSON

请求方式

GET

是否需要登录

是 关于登录授权，参见 如何登录授权

访问授权限制

暂无

请求参数

名称 类型 必选 描述
client_id string yes 申请应用时分配的AppKey
access_token string yes 授权后的access token
timestamp bigint yes 当前时间戳
company_id string yes 公司id
app_type int yes 登录链接类型：2-企业版app H5
phone string no 员工手机号，仅支持中国大陆手机号
email string no 邮箱
employee_number string no 员工工号
sign string yes 签名

注意事项

  • 新用户添加成功首次调用单点登录，会返回发送验证码链接，以此确认用户手机号是否正确；
  • 当app_type = 2时，phone、email、employee_number三者至少填写一个，且优先级如下：phone > email > employee_number，即三者存在两者以上时，以优先级高的为准；
  • 当app_type = 2时，如果返回的是跳转滴滴企业版H5的链接，则其有效期只有1分钟，且只能使用一次；
  • 当使用email或employee_number时，如果没有绑定过手机号，返回的链接为用户绑定手机号的链接，用户绑定成功之后会自动跳转到用车首页；
  • 如果是用户绑定手机号跳转到用车首页，那么接入方拼接在url中的参数都会被忽略。

返回参数说明

返回值字段 字段类型 字段说明
errno string 0表示成功，非0表示失败
errmsg string errno=0时为常量"SUCCESS"，errno!=0时为错误信息
data.encrypt_str string 绑定手机号链接、单点登录跳转h5的链接、发送验证码链接

返回示例

登录h5示例
{
    "errno":0,
    "errmsg":"SUCCESS",
    "data":{
        "encrypt_str":"https://open.es.xiaojukeji.com/webapp/feESWebappLogin/index?auth_code=eyJ0X3N0ciI6Ijc0ZTJkNDhkNWU2Mjk0YzY2Zjg0ZWI4MmViODJhYzdhIiwiY19zdHIiOiIwOGFhNWFjNzFmZTYzNGViYTQyNjA4MjdmNThjODJhNyIsInQiOjE2MjQ2MjczMDksImhfc3RyIjoiNzA1MzVjMmQwNjczMWE3NWZkZjNiNzdkYzU4ODNkOTgifQ==&phone=11000000995&company_id=6991764971512422503&client_id=diditestclient"
    },
    "request_id":"v7ohF6sWiDzQKHKxXtnXEHGTU9v7OhWqwQ5sDls5HlbUXxMB6PaXbiWOCTVg4I+a"
}
绑定手机号链接
{
    "errno":0,
    "errmsg":"SUCCESS",
    "data":{
        "encrypt_str":"https://open.es.xiaojukeji.com/webapp/feESWebapp/bindPhone?token=%2FsFZ%2BFemFB0SnR34pn5zSC4MBxmurFHnAYCB9pB32%2Fpr5E9jT2fbvsCAtEcPq8pTKMghlTv8U%2FSgxp72qAlhbiQ16i8L65vG%2F6qEf4LW8RJkf97wjTC6MwhZKxJqjXd3REP3aYtEXN3ENwo5M4uccA%3D%3D&member_type=2&member_value=test6%40163.com"
    },
    "request_id":"v7ohF6sWiDy6XaK8w0x\/FmsOPFv0\/t5B36fMwNRsLrdanw3TK+YJ2gNMP9ApgQ+w"
}
发送验证码链接示例
{
    "errno":0,
    "errmsg":"SUCCESS",
    "data":{
        "encrypt_str":"https://open.es.xiaojukeji.com/webapp/feESWebapp/sendCode?phone=QRKYo2yuJB%2FityPseUM22Q%3D%3D&token=%2FsFZ%2BFemFB3Rf2gqWH68h1%2FqcpEFzkfiDGjvFixkbK2HzqZ50rEy0NagRf5Gx%2FbUUnie3iq3nhDdhtVjxEvyjKbnewHHWTJlGJwuCDEBkx0K9rWKucv4Tcawc5DgDwlMsjq2OBtir6z6Ak7NUbeEa4nZRWvVr4nd2JTG%2FG5sm46j7768Mp8KJmXA1Gbe%2B8nIqvLXjIVUFkQbnaDxK0kcUw%3D%3D&is_first_login=1&es_from=h5"
    },
    "request_id":"i+2SqRl3AcnVn2rgpqbJffc/xVJR1RzD36KQ8cHNVqYWoBUzycljQBzl7bZJvYti"
}

接口错误解决方案

通用错误解决文档

  1. 4xx 错误
  2. 1xxx 错误

results matching ""

    No results matching ""