销售(项目成员)相关API

项目添加销售

请求地址

POST https://deal-api.kuick.cn/api/v1.7/app/{app-id}/members

是否需要认证

参数说明

参数名称 参数类别 是否必填 参数说明
app-id string 项目ID
参数名称 参数类别 是否必填 参数说明
kuick_user_id string Kuick用户ID

正常返回结果

{
    "status": 1,
    "data": {
        "id": "cf485632-99a6-48ab-9022-ebd9eacbc78a",
        "appId": "575c3ddf-5950-406f-bb1c-c11725ee29d6",
        "kuickUserId": 6150,
        "conferenceId": 8608,
        "status": 0,
        "role": "Sales",
        "createTime": "2016-12-08 17:30:38",
        "editTime": "2016-12-08 17:30:38"
    }
}

正常返回结果说明

字段名称 字段类型 字段说明
id string 记录唯一标识
appId string 项目id
kuickUserId int kuick用户id
conferenceId string 会议id
status int 销售状态,0:正常,1:删除
role string 角色,Sales:部门销售;Admin:部门管理员;Master:超级管理员
createTime date 项目成员创建时间
editTime date 项目成员编辑时间

项目移除销售

请求地址

POST https://deal-api.kuick.cn/api/v1.7/app/{app-id}/member/{kuick-user-id}

是否需要认证

参数说明

参数名称 参数类别 是否必填 参数说明
app-id string 项目ID
kuick-user-id string 项目成员id

正常返回结果

{
    "status": 1,
    "data": true
}

正常返回结果说明

字段名称 字段类型 字段说明
status int 调用状态,1:成功,0:失败
data object 销售移除成功

修改销售对应的Kuick用户信息

请求地址

POST https://deal-api.kuick.cn/api/v1.7/user/update

参数说明

参数名称 参数类别 是否必填 参数说明
user_id int 用户id
name string 用户昵称
sex int 用户性别,1为男性,2为女性
city string 城市
province string 省份
company string 公司
industry string 行业
email string 邮箱
position string 职位

返回结果

{
    "status" : 1,
    "data"  : {
        "id": 2,
        "name": "XX",
        "password": null,
        "email": null,
        "phoneNum": null,
        "openid": "oQe0ws5NkCRECz-N4yxIc5AsSGi4",
        "sex": 1,
        "city": "Haidian",
        "province": "Beijing",
        "company": "北京初出科技有限公司",
        "ccNum": 57887066,
        "emailStatus": 0,
        "phoneNumStatus": 0,
        "status": 0,
        "position": null,
        "industry": null,
        "channel": 3,
        "weixinNickname": null,
        "salesCount": null,
        "personInfoStatus": 0,
        "createdAt": "2018-02-05 17:55:10",
        "updatedAt": "2018-02-06 16:29:48",
        "unionidStatus": 0
    }
}

错误返回示例

{
    "status": 0,
    "msg": "failed update user info"
}

正常返回结果说明

字段名称 字段类型 字段说明
id int 用户id
name string 用户名
email string 用户邮箱
emailStatus int 用户邮箱验证状态 0:未验证、1:已验证
phoneNum string 用户手机号
phoneNumStatus int 用户手机号验证状态 0:未验证、1:已验证
photoURI string 用户头像
openid string 微信用户唯一标识
sex string 用户性别,1为男性,2为女性
city string 城市
province string 省份
company string 公司
ccNum int cc号:随机8位数字
company string 公司
status int 用户状态,0:新注册、1:已激活、2:已停用
position string 职位
industry string 所属行业
personInfoStatus int 用户信息完整状态,0:未完整,1:已完整
channel string 注册来源, 3: 网站;4:网站开会页面; 5: ios; 6: android; 7: 第三方合作伙伴
weixinNickname string 微信昵称
salesCount int 销售人数
personInfoStatus int 用户信息完整状态,0:未完整,1:已完整
createdAt date 用户注册时间
updatedAt date 用户修改时间
unionidStatus int 微信unionid状态,1:有、0:无

获取项目销售列表

请求地址

GET https://deal-api.kuick.cn/api/v1.7/app/{app-id}/members

是否需要认证

参数说明

参数名称 参数类别 是否必填 参数说明
app-id string 项目id
start_index int 开始索引,默认0
count int 一页记录数,默认20
keyword string 查询关键词,支持姓名、手机号和邮箱

正常返回结果

{
    "status": 1,
    "data": [{
        "id": "e701b797-f875-43f1-aa7d-f8cf34ef0108",
        "appId": "7039d7be-3dac-41ba-a54a-f306e127bb72",
        "kuickUserId": 6,
        "conferenceId": 2331,
        "status": 0,
        "createTime": "2016-10-28 17:05:43",
        "editTime": "2016-10-28 17:05:43",
        "role": "admin",
        "postRoles": [
            "MarketPost",
            "SalesPost"
        ],
        "isOwner": true,
        "user": {
            "id": 3706,
            "conferenceId": 2331,
            "userId": 6,
            "userName": "XX",
            "userPhotoURL": "https://cdn-img-oss-test.kuick.cn/user/header/65d44f27-6486-4d34-a240-88c673463b34.jpg",
            "createdAt": "2016-10-28 17:05:42",
            "updatedAt": "2016-10-28 17:05:42",
            "phoneNum": "18810514632",
            "phoneStatus": 1,
            "email": "weilong@kuick.cn",
            "onlineStatus": 1
        }
    }, {
        "id": "582e5d77-e122-4209-90b5-d26304c1910c",
        "appId": "7039d7be-3dac-41ba-a54a-f306e127bb72",
        "kuickUserId": 9151,
        "conferenceId": null,
        "status": 0,
        "createTime": "2016-10-28 17:58:45",
        "editTime": "2016-10-28 17:58:45",
        "role": "member",
        "postRoles": [
            "MarketPost",
            "SalesPost"
        ],
        "isOwner": true,
        "user": {
            "id": 3709,
            "conferenceId": 2331,
            "userId": 9151,
            "userName": "未激活账000",
            "userPhotoURL": "http://cdn-img.test.kuick.cn/user/header/ecb48c11-45d8-4e53-acf7-5b195666c480.jpg",
            "createdAt": "2016-10-28 17:58:45",
            "updatedAt": "2016-10-28 17:58:45",
            "phoneNum": "1316756599611",
            "phoneStatus": 1,
            "email": null,
            "onlineStatus": 0
        }
    }
    ...
    ]
}

返回结果说明

字段名称 字段类型 字段说明
id string 成员id
appId string 项目id
kuickUserId int kuick用户id
status int 成员状态,0:正常,1:删除
role string 角色,Sales:部门销售;Admin:部门管理员;Master:超级管理员
user object 成员对应的Kuick用户信息
userName string kuick用户名称
userPhotoURL string kuick用户头像
email string kuick用户邮箱
photoNum string kuick用户手机号
onlineStatus int 在线状态: 1:在线:0:不在线
postRoles string数组 职能信息: MarketPost:市场,SalesPost:销售
isOwner string 是否是创建者: true:是,false否
北京西会科技有限公司©2015-2018 all right reserved,powered by Gitbook该文件修订时间: 2018-11-21 01:53:15

results matching ""

    No results matching ""