# 1.2 用户信息

# 1.2.1 获取用户信息

第三方应用可以使用此接口查询企业用户基本信息

请求方式: POST(HTTPS
请求地址: https://{region}/service/oauth/provider/getUserInfo?access_token=2019040189580858920907506625723500936366986112&msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608&timestamp=1403610513&nonce=380320359
请求示例:

{
        "user_id":"7102807924041722259",
        "user_type":"1"
}

参数说明:

参数 是否必须 说明
access_token 应用授权AccessToken,生成方法详见 1.1.1 应用获取AccessToken (opens new window)
msg_signature 请求数据签名,生成方法详见 1.5.1 数据签名生成方法 (opens new window)
timestamp 请求时间戳,如:1503276678552
nonce 随机字符串,最长为128字节
user_id user_type=1,对应勤策用户id
user_type=2,对应客户id
user_type=3,对应客户联系人id
user_type 用户类型。1:用户,2:客户,3:客户联系人

响应示例:

{
    "return_code":0,
    "return_msg":"success",
    "return_data": {
        "tenant_id":"7102807924041722259",
        "id":"7102807924041722259",
        "name":"张三",
        "user_type": "1",
        "status":"1",
        "depart_id":"5222557594701155252",
        "depart_name":"经营部",
        "full_depart_name":"/总公司/华中大区/销售部/经营部",
        "thrid_id":"244d5c86d3c342f992ced55729fb6f05"
    }
}

参数说明:

参数 说明
return_code 响应码
return_msg 对返回码的文本描述内容
tenant_id 企业ID,最长为32字节
id 企业员工唯一ID,最长为32字节
name 用户名称,最长为100字节
user_type 用户类型。1:用户,2:客户,3:客户联系人
status 用户状态。1:正常,2:停用,0:销户
depart_id 用户所在部门ID
depart_name 用户所在部门名称
full_depart_name 用户所在部门全路径,如"/总公司/华中大区/销售部/经营部"
thrid_id 来源第三方的唯一ID,最长为100字节

# 1.2.2 获取客户信息

第三方应用可以使用此接口查询企业客户基本信息

请求方式: POST(HTTPS
请求地址: https://{region}/service/oauth/customer/getCustomerInfo?access_token=2019040189580858920907506625723500936366986112&msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608&timestamp=1403610513&nonce=380320359
请求示例:

{
        "customer_id":"7102807924041722259"
}

参数说明:

参数 是否必须 说明
access_token 应用授权AccessToken,生成方法详见 1.2 应用获取AccessToken (opens new window)
msg_signature 请求数据签名,生成方法详见 1.5.1 数据签名生成方法 (opens new window)
timestamp 请求时间戳,如:1503276678552
nonce 随机字符串,最长为128字节
customer_id 企业客户唯一ID

响应示例:

{
    "return_code": 0,
    "return_msg": "success",
    "return_data": {
        "tenant_id":"7102807924041722259",
        "id": "8972168206592733416",
        "code": "CUS1017269",
        "name": "南京建邺区苏果超市",
        "district_id": "5626196378531590284",
        "district_name": "南京",
        "full_district_name": "全国销售管理/北方大区/南京办/南京",
        "thrid_id":"244d5c86d3c342f992ced55729fb6f05"
    }
}

参数说明:

参数 说明
return_code 响应码
return_msg 对返回码的文本描述内容
tenant_id 企业ID,最长为32字节
id 企业客户唯一ID,最长为32字节
code 客户编码,最长为100字节
name 客户名称,最长为100字节
district_id 客户销售区域ID,最长为32字节
district_name 客户销售区域名称,最长为100字节
full_district_name 客户销售区域全路径,如"/总公司/华中大区/销售部/经营部"
thrid_id 来源第三方的唯一ID,最长为100字节

# 1.2.3 获取客户联系人信息

第三方应用可以使用此接口查询企业客户基本信息

请求方式: POST(HTTPS
请求地址: https://{region}/service/oauth/customer/getCustomerLinkmanInfo?access_token=2019040189580858920907506625723500936366986112&msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608&timestamp=1403610513&nonce=380320359
请求示例:

{
        "linkman_id":"7102807924041722259"
}

参数说明:

参数 是否必须 说明
access_token 应用授权AccessToken,生成方法详见 1.2 应用获取AccessToken (opens new window)
msg_signature 请求数据签名,生成方法详见 1.5.1 数据签名生成方法 (opens new window)
timestamp 请求时间戳,如:1503276678552
nonce 随机字符串,最长为128字节
linkman_id 客户联系人唯一ID

响应示例:

{
    "return_code": 0,
    "return_msg": "success",
    "return_data": {
        "tenant_id":"7102807924041722259",
        "id": "7102807924041722259",
        "mobile": "18000000001",
        "name": "张三",
        "is_main": "1",
        "cm_id": "8972168206592733416",
        "cm_name": "南京建邺区苏果超市",
        "cm_code": "CUS1017269",
        "thrid_id":"244d5c86d3c342f992ced55729fb6f05"
    }
}

参数说明:

参数 说明
return_code 响应码
return_msg 对返回码的文本描述内容
tenant_id 企业ID,最长为32字节
id 客户联系人唯一ID,最长为32字节
mobile 客户联系人手机,最长为11字节
is_main 是否主联系人。0:否,1:是
name 客户联系人名称,最长为100字节
cm_id 客户ID,最长为32字节
cm_code 客户编码,最长为100字节
cm_name 客户名称,最长为100字节
thrid_id 来源第三方的唯一ID,最长为100字节