创建SmartCare快速定界任务接口 (submitquickdelimit)
场景描述
创建SmartCare快速定界任务。
接口方法
POST
接口URI
https://域名/apiaccess/CC-Management/v1/smartcare/submitquickdelimit,例如域名是service.besclouds.com
请求说明
序号 | 名称 | 参数类型 | 是否必选 | 说明 |
|---|---|---|---|---|
1 | X-APP-Key | string | True | appKey字段,用户标识 |
2 | Authorization | string | True | 鉴权字段,内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken(Bearer后有空格) |
序号 | 名称 | 参数类型 | 是否必选 | 说明 |
|---|---|---|---|---|
1 | msisdn | String | True | 用户手机号码。 |
2 | startTime | String | True | 快速定界开始时间,租户时区时间。 例如1721283033000 配置为当前时间往回推租户级参数“SmartCare定界创建时开始时间字段往前推的时间(h)”的值后的时间。 |
3 | endTime | String | True | 快速定界结束时间,租户时区时间。 例如1721283133000 配置为当前时间,即创建任务的时间。 |
4 | locale | String | True | 语言。
说明:
|
5 | scene | String | True | 场景。 场景预设配置的场景必须与该场景名称一致才能定界。 |
6 | longitude | String | False | 经度。 取值范围:[-180, 180],最多包含6位小数。 |
7 | latitude | String | False | 纬度。 取值范围:[-90, 90],最多包含6位小数。 |
8 | radius | String | False | 半径。 取值为非负整数,单位为:米。 |
响应说明
- 响应状态码: 200
表3 响应体参数 序号
名称
参数类型
是否必选
说明
1
returnCode
String
True
响应码,成功为0。
2
description
String
True
响应描述信息。
3
taskId
String
True
创建的SmartCare快速定界任务ID。
- 响应状态码: 400
错误的请求:请检查请求路径及参数。
- 响应状态码: 401
未授权:1.请确认是否购买了相关服务。2.请联系客服人员检查您账号的当前状态。
- 响应状态码: 404
请求的内容未找到:请检查请求的路径。
- 响应状态码: 500
业务失败:请依次确认您请求中各参数的取值。
报文样例
请求头:
x-app-key:9******************************3 Authorization:Bearer e******************************e Content-Type:application/json
请求参数:
{
"msisdn": "6680512100869",
"startTime": "1721283033000",
"endTime": "1721283133000",
"scene": "Voice",
"locale": "en_US"
} 响应参数:
{
"returnCode": "0",
"description": "Queried successfully. Data is available.",
"taskId": "7532351aa3fb4fcc9eff66e6d5606f7f"
} 
