更新用户信息

POST

/{modify_cb}

用户的唯一性标识和被修改的信息会被作为请求内容 POST 到该接口，与获取信息不一样的是，更新类接口POST提交数据的方式为application/x-www-form-urlencoded。

接口地址由获取用户信息接口/get_user_info返回的modify_cb的内容指定。

注意：userid来源于用户发起会话时，调用各端 SDK 的初始化代码时传递给网易七鱼系统的参数中。

其中data用一个数组描述提交修改的数据，数组的每个元素表示一个数据项。数据项以<key, value>对的形表示：

字段	类型	必须	说明
`key`	String	是	数据项的名称，用于区别不同的数据。`key`的值来源于获取用户信息`/get_user_info`接口返回的信息中对应数据项的`key`。
`value`	String	是	该数据修改后的值。都视为字符串进行传输。

需要注意的是，客服平台前端采用失焦保存策略（鼠标移开后点击其他区域变自动保存），所以每次只能修改一个参数。该策略能为客服减少操作，提升效率。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://qiyukf.com/' \
--data-urlencode 'appid=qiyukf' \
--data-urlencode 'token=qiyukf_security_token' \
--data-urlencode 'userid=zhangsan' \
--data-urlencode 'data=[        {"key":"name", "value":"张三"},        {"key":"phone", "value":"1397777777X"}    ]'

响应示例

{
    "rlt": 0,
    "data": [
        {
            "key": "name",
            "msg": "名字太长了。"
        },
        {
            "key": "phone",
            "msg": "手机号格式错误。"
        }
    ]
}

请求参数

Path 参数

modify_cb

string

必需

接口地址由获取用户信息接口/get_user_info返回的modify_cb的内容指定。

Body 参数application/x-www-form-urlencoded

appid

string

必需

企业分配给网易七鱼系统的 appid。

示例值:

qiyukf

token

string

必需

当前有效的 token。

示例值:

qiyukf_security_token

userid

string

用户的唯一性标识。

必需

示例值:

zhangsan

data

string

必需

用一个数组表示修改的用户信息数据。

示例值:

[ {"key":"name", "value":"张三"}, {"key":"phone", "value":"1397777777X"} ]

返回响应

🟢200成功

application/json

Body

rlt

integer

必需

表明接口调用是否成功。值为0时表示接口调用成功。关于错误码的详细描述，见Appendix I节。

data

array [object {2}]

可选

当rlt不为0时，用一个数组表示每项数据修改失败的原因提示。

key

string

必需

数据项的名称，用于区别不同的数据。对应请求中数据项的key。

msg

string

必需

该项数据修改失败的错误提示。

修改于 2022-01-28 04:24:28

呼叫中心获取电话用户信息

在线会话获取用户订单信息