推送采集數(shù)據(jù)
描述
給指定的應(yīng)用推送采集數(shù)據(jù)
方法
POST
URI
/v3/openapi/app-groups/{appName}/data-collections/{dataCollectionName}/data-collection-type/{dataCollectionType}/actions/bulk
appName 指的是 opensearch 應(yīng)?名稱
dataCollectionName 指的是數(shù)據(jù)采集名稱,默認(rèn)為 opensearch 應(yīng)?名稱
dataCollectionType 指的是數(shù)據(jù)采集類型,為 USER、ITEM_INFO、BEHAVIOR、INDUSTRY_SPECIFIC 四種類型之一
以上省略了請(qǐng)求 Header 參數(shù),省略了訪問(wèn) opensearch 服務(wù)的 Host 地址, 詳細(xì)請(qǐng)求結(jié)構(gòu)請(qǐng)參考文檔
請(qǐng)求參數(shù)
名稱 | 類型 | 是否必選 | 描述 |
docs | List | 是 | 由Doc組成的數(shù)據(jù) |
Doc 的參數(shù)
名稱 | 類型 | 是否必選 | 描述 |
cmd | String | 是 | 操作指令,必須為 ADD |
fields | Map | 是 | 字段組合 |
fields 的參數(shù)
fields 是指定表的字段組合,我們定義了不同類型的表結(jié)構(gòu),分別是用戶表、物品表和行為表。例如需要向其行為表推送數(shù)據(jù)的時(shí)候,fields 就應(yīng)該是 行為表 中的定義的字段。
名稱 | 類型 | 是否必選 | 描述 |
field1 | xxx | 是 | 表字段 |
field2 | xxx | 是 | 表字段 |
返回參數(shù)
參數(shù) | 類型 | 描述 |
errors | List | 錯(cuò)誤內(nèi)容 |
status | String | status:執(zhí)行結(jié)果,OK為成功,F(xiàn)AIL為失敗,請(qǐng)根據(jù)返回錯(cuò)誤碼進(jìn)行排查 |
request_id | String | 當(dāng)前請(qǐng)求的 request_id |
result | Boolean | 執(zhí)行成功返回該參數(shù),值為true,報(bào)錯(cuò)不返回該參數(shù) |
示例
請(qǐng)求示例
POST /v3/openapi/app-groups/zhao_special/data-collections/zhao_special/data-collection-type/behavior/actions/bulk
[
{
"cmd": "ADD",
"fields": {
"sdk_type": "opensearch_sdk",
"sdk_version": "3.2.0",
"user_id": "10469628",
"biz_id": 123,
"trace_id": "231084198510103333",
"item_id": "id",
"item_type": "item",
"bhv_type": "click",
"reach_time": "20190730105931"
}
}
]
正常返回示例
{
"errors": [],
"request_id": "155084740119723291017595",
"status": "OK",
"result": true
}