通知接口
更新时间：2021-12-21
新建通知接口
接口描述
创建通知。
请求（Request）
- 请求语法：
Http
1POST /v{version}/notification HTTP/1.1
2x-bce-date: {utc-date-string}
3host: bvw.bj.baidubce.com
4content-type: application/json
5authorization: {bce-authorization-string}- 请求头域：无特殊Header参数
- 请求参数：
| 字段名称 | 字段类型 | 是否必选 | 字段描述 | 参数位置 |
|---|---|---|---|---|
| name | String | 必选 | 通知名称，最大长度128字符 | Requestbody |
| endpoint | String | 必选 | 通知地址，最大长度256字符 | Requestbody |
| token | String | 可选 | 通知验证token，最大长度32字符，支持大小写字母和数字 | Requestbody |
| authType | Enum | 可选 | 通知验证类型，NONE：无验证，SIGN：签名验证默认为NONE | Requestbody |
- 请求示例：
Http
1POST /v1/notification HTTP/1.1
2x-bce-date: 2019-05-31T09:27:33Z
3host: bvw.bj.baidubce.com
4content-type: application/json
5authorization: bce-auth-v1/c0188830c0c342928f199bbbdac4c227/2019-05-31T09:27:33Z/1800/host/f19dfaf46b9e6b619e9be203650701a2bec9db18a980686ddb3a3a58132558e1
6{
7 "name":"notification",
8 "endpoint": "http://localhost:8000/callback/url"
9 "token": "qeA4p01Nb",
10 "authType": "SIGN"
11}响应（Response）
- 响应头域：无特殊Header参数
- 响应参数：无
- 响应示例：
Http
1HTTP/1.1 200 OK
2Transfer-Encoding: chunked
3x-bce-request-id: ca8620b4-0527-4153-b6ed-3a6c0a4da937
4Cache-Control: no-cache
5Server: BWS
6Date: Fri, 31 May 2019 09:27:33 GMT
7Content-Type: application/json;charset=UTF-8删除通知接口
接口描述
根据通知名称删除指定通知信息。
请求（Request）
- 请求语法
Http
1DELETE /v{version}/notification/{name} HTTP/1.1
2x-bce-date: {utc-date-string}
3host: bvw.bj.baidubce.com
4content-type: application/json
5authorization: {bce-authorization-string}- 请求头域：无特殊Header参数
- 请求参数：无
- 请求示例：
Http
1DELETE /v1/notification/{name} HTTP/1.1
2x-bce-date: 2015-07-03T09:28:13Z
3host: bvw.bj.baidubce.com
4content-type: application/json
5authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715响应（Response）
- 响应头域：无特殊Header参数
- 响应参数：无
- 响应示例：
Http
1HTTP/1.1 200 OK
2x-bce-request-id: 6d0b0a36-2ffe-49d4-9d81-333a9ab9417e
3Date: Tue, 24 Mar 2015 13:06:02 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6Cache-Control: no-cache更新通知接口
接口描述
根据通知名称更新指定通知信息。
请求（Request）
- 请求语法
Http
1PUT /v{version}/notification/{name} HTTP/1.1
2x-bce-date: {utc-date-string}
3host: bvw.bj.baidubce.com
4content-type: application/json
5authorization: {bce-authorization-string}- 请求头域：无特殊Header参数
- 请求参数：
| 字段名称 | 字段类型 | 必要性 | 字段描述 | 参数位置 |
|---|---|---|---|---|
| endpoint | String | 可选 | 通知地址，最大长度256字符 | Requestbody |
| token | String | 可选 | 通知验证token，最大长度32字符，支持大小写字母和数字 | Requestbody |
| authType | Enum | 可选 | 通知验证类型，NONE：无验证，SIGN：签名验证；默认为NONE | Requestbody |
1、endpoint/token/authType三个请求参数至少一个不为空。
- 请求示例：
Http
1PUT /v1/notification/{name} HTTP/1.1
2x-bce-date: 2015-07-03T09:28:13Z
3host: bvw.bj.baidubce.com
4content-type: application/json
5authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715
6{
7 "endpoint": "http://localhost:8000/callback/url"
8 "token": "zxcASD123",
9 "authType": "SIGN"
10}响应（Response）
- 响应头域：无特殊Header参数
- 响应参数：无
- 响应示例：
Http
1HTTP/1.1 200 OK
2x-bce-request-id: 6d0b0a36-2ffe-49d4-9d81-333a9ab9417e
3Date: Tue, 24 Mar 2015 13:06:02 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6Cache-Control: no-cache查询通知信息
接口描述
根据通知名称查询指定通知信息。
请求（Request）
- 请求语法
Http
1GET /v{version}/notification/{name} HTTP/1.1
2x-bce-date: {utc-date-string}
3host: bvw.bj.baidubce.com
4content-type: application/json
5authorization: {bce-authorization-string}- 请求头域：无特殊Header参数
- 请求参数：无
- 请求示例：
Http
1GET /v1/notification/{name} HTTP/1.1
2x-bce-date: 2015-07-03T09:28:13Z
3host: bvw.bj.baidubce.com
4content-type: application/json
5authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715响应（Response）
- 响应头域：无特殊Header参数
- 响应参数：
| 字段名称 | 字段类型 | 字段描述 |
|---|---|---|
| name | String | 通知名称 |
| endpoint | String | 通知地址 |
| status | Object | 通知状态，状态值：ENABLE/DISABLE |
| token | String | 通知验证token |
| authType | String | 通知验证类型 |
| createTime | String | 通知创建时间 |
| updateTime | String | 通知修改时间 |
- 响应示例：
Http
1HTTP/1.1 200 OK
2x-bce-request-id: 6d0b0a36-2ffe-49d4-9d81-333a9ab9417e
3Date: Tue, 24 Mar 2015 13:06:02 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6Cache-Control: no-cache
7{
8 "name":"notification",
9 "endpoint": "http://localhost:8000/callback/url",
10 "status":"DISABLE",
11 "token": "",
12 "authType": "NONE",
13 "createTime":"2015-03-25T13:37:10Z",
14 "updateTime":"2015-04-25T13:37:10Z"
15}查询通知列表
接口描述
查询通知列表。
请求（Request）
- 请求语法
Http
1GET /v{version}/notification?status={status} HTTP/1.1
2x-bce-date: {utc-date-string}
3host: bvw.bj.baidubce.com
4content-type: application/json
5authorization: {bce-authorization-string}- 请求头域：无特殊Header参数
- 请求参数：
| 字段名称 | 字段类型 | 必要性 | 字段描述 | 参数位置 |
|---|---|---|---|---|
| status | Object | 可选 | 状态，状态值：ENABLE/DISABLE | Query |
- 请求示例：
Http
1GET /v1/notification?status=ENABLE HTTP/1.1
2x-bce-date: 2015-07-03T09:28:13Z
3host: bvw.bj.baidubce.com
4content-type: application/json
5authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715响应（Response）
- 响应头域：无特殊Header参数
- 响应参数：
| 字段名称 | 字段类型 | 字段描述 |
|---|---|---|
| notifications | Array | 通知列表 |
| +name | String | 通知名称 |
| +endpoint | String | 通知地址 |
| +status | String | 状态，状态值：ENABLE/DISABLE |
| +token | String | 通知验证token |
| +authType | String | 通知验证类型 |
| +createTime | String | 通知创建时间 |
| +updateTime | String | 通知修改时间 |
- 响应示例：
Http
1HTTP/1.1 200 OK
2x-bce-request-id: 6d0b0a36-2ffe-49d4-9d81-333a9ab9417e
3Date: Tue, 24 Mar 2015 13:06:02 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6Cache-Control: no-cache
7{
8 "notifications": [
9 {
10 "notificationId": "not-jgsevd7fj24i6eri",
11 "name": "test",
12 "endpoint": "http://10.145.80.177:8902/internal/v1/callback/mock/notification",
13 "status": "ENABLE",
14 "token": "",
15 "authType": "NONE",
16 "createTime": "2019-07-17T04:04:39Z",
17 "updateTime": "2019-07-17T04:54:13Z"
18 },
19 {
20 "notificationId": "not-jgtn14r76cjf8f27",
21 "name": "test2",
22 "endpoint": "http://12313",
23 "status": "DISABLE",
24 "token": "as14gsGz",
25 "authType": "SIGN",
26 "createTime": "2019-07-18T12:13:32Z",
27 "updateTime": "2019-07-22T14:29:47Z"
28 },
29 {
30 "notificationId": "not-jgyj8s7znx0k4sde",
31 "name": "test_20190723",
32 "endpoint": "http://test.com/callback",
33 "status": "ENABLE",
34 "token": "",
35 "authType": "NONE",
36 "createTime": "2019-07-23T09:18:52Z",
37 "updateTime": "2019-07-23T09:18:52Z"
38 }
39 ]
40}停用通知接口
接口描述
根据通知名称停用指定通知。
请求（Request）
- 请求语法：
Http
1PUT /v{version}/notification/{name}?disable HTTP/1.1
2x-bce-date: {utc-date-string}
3host: bvw.bj.baidubce.com
4content-type: application/json
5authorization: {bce-authorization-string}- 请求头域：无特殊Header参数
- 请求参数：无
- 请求示例：
Http
1PUT /v1/notification/{name}?disable HTTP/1.1
2x-bce-date: 2015-07-03T09:28:13Z
3host: bvw.bj.baidubce.com
4content-type: application/json
5authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715响应（Response）
- 响应头域：无特殊Header参数
- 响应参数：无
- 响应示例：
Http
1HTTP/1.1 200 OK
2x-bce-request-id: 6d0b0a36-2ffe-49d4-9d81-333a9ab9417e
3Date: Tue, 24 Mar 2015 13:06:02 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6Cache-Control: no-cache启用通知接口
接口描述
根据通知名称启用指定通知。
请求（Request）
- 请求语法：
Http
1PUT /v{version}/notification/{name}?enable HTTP/1.1
2x-bce-date: {utc-date-string}
3host: bvw.bj.baidubce.com
4content-type: application/json
5authorization: {bce-authorization-string}- 请求头域：无特殊Header参数
- 请求参数：无
- 请求示例：
Http
1PUT /v1/notification/{name}?enable HTTP/1.1
2x-bce-date: 2015-07-03T09:28:13Z
3host: bvw.bj.baidubce.com
4content-type: application/json
5authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2015-07-03T09:28:13Z/1800/content-type;host;x-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715响应（Response）
- 响应头域：无特殊Header参数
- 响应参数：无
- 响应示例：
Http
1HTTP/1.1 200 OK
2x-bce-request-id: 6d0b0a36-2ffe-49d4-9d81-333a9ab9417e
3Date: Tue, 24 Mar 2015 13:06:02 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6Cache-Control: no-cache