任务接口

上传 ID 文件

有一些客情分析任务,需要上传一个座标列表、用户ID、IMEI、IDFA 或者 MAC 地址列表,在创建任务之前,需要先向系统上传这个列表文件。

URL

POST v1/custominsight/carapi/task_idupload

请求参数

key 必选 含义 解释
file_type Y 文件类型 [coor-list, user-list, 4s-shop]
file_name Y 文件名称

请求示例

说明:全大写的字符串为需要替换的字符串

curl  'http://XXX/v1/custominsight/api/task_idupload' \
-H 'Content-Type: multipart/form-data' \
-H 'X-Bce-Account: CLOUD_UID' \
-F "file_type=coor-list"  \
-F 'file=@FILE_NAME'

文件规范

如果 file_type 的值是 coor-list,它的文件小于20MB,lbs点个数少于100,它的格式必须是下面这种:

3 # 第一个字符代表 lbs 类型。2: 家;3: 公司; 4: 常访地; 下面每一行是圈人的莫卡托座标的 x,y,半径(单位:米,范围[50, 5000])
北京市-北京市 #省份-城市名,参见文档后附表
13720901.4423,5955246.29112,500
11863671.4196,3391628.72711,500
12720026.5214,3573654.1187,500
12698898.1787,4196728.01751,500
14193642.3151,4409318.8246,500
13025056.6708,4367359.23119,500

第一行,使用一个数字代表 lbs 类型,取值如下:

  • 2: 家
  • 3: 公司
  • 4: 常访地

从第二行开始,每一行是一个莫卡托座标的 x,y,半径(单位: 米)

如果 file_type 的值是 user-list,文件行数必须大于300,小于100万,且文件小于20MB,它的格式必须是下面这种:

4
000145081194840D649C1CF4291B818C
00019A711CAFB9E0A3B79EB66CBC8D2D
00019EAC5F91E9A0C1696A5165B40085
0001C91560448826308B5EA4B089B82E
000208877605309EB859FE80FBE439CA
000228339610AEFCC5E16BB601EE53AC
0003438E77298540EF66B4467CEB2020

第一行,使用一个数字代表 ID 类型:

  • 1: IMEI (354960056441535)
  • 2: MAC (A4:57:C4:89:E4:E7)
  • 3: IDFA (009DA6AD-B52F-4022-A223-476C86736103)
  • 4: 手机号md5 (00019EAC5F91E9A0C1696A5165B40085)

从第二行开始,每一行都是一个 ID。

返回结果

如果请求成功,返回的 content 如下

{
    "content": {
        "file": {
            "file_token": "55330c4ee66dc6853b37ad7edc9b5947",
            "file_size": 34234,
            "file_name": "test.txt"
            "row_count": 5000
            "file_type": "coor-list",
            "rel_path": "ci-upload\/uid\/2018-03-20\/64f09df907119925d8b8e87e7cc58537.txt",
            "file_ln": 280
        }
    }
}

创建任务 -- 关键词任务

用来创建一个客情分析任务,圈人的类型为通过检索的关键词圈人。

URL

POST v1/custominsight/api/task_create

请求参数

key 必选 含义 解释
action_type Y 任务类型 keyword
action_name Y 任务名称
keyword_combine Y 多个词的计算规则 #: 与; $: 或
date_range Y 检索发生的日期 10: 一个月;11: 两个月; 12: 三个月
keyword_list Y 检索词列表 通过“;” 分割的关键词列表

请求示例

curl  'http://XXX/v1/custominsight/api/task_create' \
-H 'X-Bce-Account: CLOUD_UID' \
-d 'action_type=keyword&action_name=test1&keyword_combine=#&date_range=12&keyword_list=三里屯;车'

返回结果

请求成功,返回系统生成的任务ID号,content格式如下

{
    "content": {
        "task": 10000034
}