# 销售机会操作事件


**请求参数（未加密）**

| 请求参数名     | 类型     | 说明                       |
| -------------- | -------- | ----------------------- |
| data           | `Object` | 消息体                   |
| data.event     | `String` | 事件名                   |
| data.body      | `String` | 数据内容                 |
| data.body.type | `String` | 事件类型,del、add、update |
| data.body.id   | `String` | 销售机会id               |

**请求参数（加密）**

| 请求参数名             | 类型     | 说明                                                           |
| ---------------------- | -------- | ------------------------------------------------------------|
| data                   | `Object` | 消息体                                                       |
| data.event             | `String` | 事件名                                                       |
| data.body              | `String` | 返回加密的数据结构，需要对body.encrypt进行解密，其中参数：msgSignature，timeStamp，nonce属于解密参数，详情见文档首页加解密SDK描述 |
| data.body.encrypt      | `String` | 加密内容                                                     |
| data.body.msgSignature | `String` | 解密参数                                                     |
| data.body.timeStamp    | `String` | 解密参数                                                     |
| data.body.nonce        | `String` | 解密参数                                                     |



**请求参数示例**
`json` - Request-Example-加密:

```json
{
	"event": "saleChance",
	"body": {
		"encrypt": "ZcaBSTGyKGu5/MknLgXop/ZIe++db5OOqS19OLEytr9KZhUQsMONpQwmOo9ZfkEWbxvTRq8TFFSqnqdzSzuw==",
		"msgSignature": "fc3a056e34f6b9e1891a9d00841e27e1761e4959",
		"timeStamp": "1635302196",
		"nonce": "Kocpj4zdaBDZcWB2"
	}
}
```

注：解密encrypt后的json结构如下

```json
{
	"type": "update",
	"id": "250feed9-1111-1111-1111-f285b9cf4ac7"
}
```

`json` - Request-Example-不加密:

```json
 {
   "event":"saleChance",
	"body":{
        "type":"add",
        "id":"F1XHFEomEfx2kVFF1Q"
    }
}
```

目前销售机会事件仅会推送变更销售机会的id，具体事件类型由body解密的type判断。
type支持的值：add(新增销售机会)/del(删除销售机会)/update(销售机会更新)。
三方拿到销售机会id后调用拉取接口获取销售机会的全量信息进行数据同步。
特别注意：建议收到消息推送后立刻返回成功响应示例，避免一直占用请求连接，被判超时。
推送限制：多次响应超时、服务器无响应、多次响应失败，10分钟内达到100次，推送接口将降低所有推送事件频率为3小时一次。



**当收到请求后, 需及时响应**

| 响应参数名 | 类型     | 说明                         |
| ---------- | -------- | ------------------------- |
| code       | `Int`    | 响应码:状态码 0 失败，1 成功  |
| msg        | `String` | 响应提示                   |

**成功响应示例**

```json
{
    "code": 1,
    "msg": "成功"
}
```

**错误响应示例**

```json
{
    "code": 0,
    "msg": "处理失败"
}
```