2 用户信息

2.1 获取用户信息

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

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/service/oauth/provider/getUserInfo?access_token=2019040189580858920907506625723500936366986112&msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608&timestamp=1403610513&nonce=380320359
请求包体:

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

参数说明:

参数 是否必须 说明
access_token 应用授权AccessToken
msg_signature 请求数据签名,生成方法详见 1.5 数据签名生成方法
timestamp 请求时间戳
nonce 随机字符串
user_id 企业员工唯一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-客户
status 用户状态 1-正常 2-停用 0-销户
depart_id 用户所在部门ID
depart_name 用户所在部门名称
full_depart_name 用户所在部门全路径

2.2 获取客户信息

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

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/service/oauth/customer/getCustomerInfo?access_token=2019040189580858920907506625723500936366986112&msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608&timestamp=1403610513&nonce=380320359
请求包体:

{
        "customer_id":"7102807924041722259"
}

参数说明:

参数 是否必须 说明
access_token 应用授权AccessToken
msg_signature 请求数据签名,生成方法详见 1.5 数据签名生成方法
timestamp 请求时间戳
nonce 随机字符串
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 客户销售区域全路径

2.3 获取客户联系人信息

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

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/service/oauth/customer/getCustomerLinkmanInfo?access_token=2019040189580858920907506625723500936366986112&msg_signature=3a7b08bb8e6dbce3c9671d6fdb69d15066227608&timestamp=1403610513&nonce=380320359
请求包体:

{
        "linkman_id":"7102807924041722259"
}

参数说明:

参数 是否必须 说明
access_token 应用授权AccessToken
msg_signature 请求数据签名,生成方法详见 1.5 数据签名生成方法
timestamp 请求时间戳
nonce 随机字符串
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字节