# 用户留言
#### 接口功能
用户留言保存
#### 使用说明
前提条件
正确创建web渠道配置。
#### 接口原型
表1接口原型说明 
|   请求方法    |                                                      POST                                                      ||
|---|---|---|
| **请求URL** | https://ip:port/service-cloud/rest/webadapter/v1/webadapterfacade/doLeaveMessage | 其中，ip:port为对外暴露的nslb的ip和port |
   
表2请求Headers参数说明 
| 参数名称         | 选取原则 | 参数类型   | 默认值 | 说明                                                                                                                               |
|:---|:---|:---|:---|:---|
| Content-Type | 必选   | String | 无   | 固定填 application/json;charset=UTF-8。                                                                                              |
| Cookie       | 必选   | String | 无   | 集成页面的时候，ccmessaging通过请求响应，将ccmessaging-token写到集成页面浏览器的Cookie中。单独调用时需确保请求头的Cookie中含有ccmessaging-token=xxx，xxx为ccmessaging-token值。 |
   
#### 请求参数
| 参数名称         | 选取原则 | 参数类型   | 说明   |
|:---|:---|:---|:---|
| phoneNo      | 必选   | String | 联系号码 |
| leaveMessage | 必选   | String | 留言内容 |
   
#### 响应参数
| 参数名称        | 选取原则 | 参数类型   | 说明                                                                           |
|:---|:---|:---|:---|
| resultCode  | 必选   | String | 接口响应码，0：成功                                                                   |
| resultDesc  | 必选   | String | 接口描述                                                                         |
| returnCode  | 必选   | String | 接口响应码（0或3）                                                                   |
| description | 必选   | String | 接口错误描述（returnCode为0时，返回空，returnCode为3时，返回"the leaveMessageParams is error."） |
   
#### 接口示例
- 请求示例
  ```
  POST /service-cloud/rest/webadapter/v1/webadapterfacade/doLeaveMessage
  host: 10.10.10.2:18446
  connection: Keep-Alive
  x-forwarded-for: 10.10.10.3, 10.10.10.4
  x-real-ip: 10.10.10.5
  content-length: 401
  remote-host: 10.10.10.6
  user-agent: java/socket
  content-type: application/json;charset=UTF-8
  cookie: JSESSION*****#*#*****3
  ccmessaging-token：********
  accept: */*
  ```
  
- 入参示例
  ```
  {
      "phoneNo": "123456",
      "leaveMessage": "12122331"
  }
  ```
  
- 响应示例
  ```
  {
      "returnCode": "0",
      "resultCode": "0",
      "description": "",
      "resultDesc": "Save leaveMessage success!"
  }
  ```