创建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"
}
