API开放平台

TIP

# 1.2 用户信息

# 1.2.1 获取用户信息

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

请求方式： POST（HTTPS）
请求地址： https://sso.qince.com/service/oauth/provider/getUserInfo?access_token=2019040189580858920907506625723500936366986112&msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608&timestamp=1403610513&nonce=380320359
请求示例：

{
        "user_id":"7102807924041722259"
}

参数说明：

参数 是否必须 说明
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

响应示例：

{
    "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字节
code 用户登录帐号,最长为100字节
name 用户名称,最长为100字节
user_type 用户类型。1：员工,3:客户联系人
status 用户状态。1：正常，2：停用，0：销户
depart_id 用户所在部门ID
depart_name 用户所在部门名称
position 用户职务名称
full_depart_name 用户所在部门全路径，如"/总公司/华中大区/销售部/经营部"
thrid_id 来源第三方的唯一ID,最长为100字节
mobile 勤策员工手机号

# 1.2.2 获取客户信息

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

请求方式： POST（HTTPS）
请求地址： https://sso.qince.com/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://sso.qince.com/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字节

← 1.3 JSAPI →