接口說明

POST /api/rec/feed

請求參數

item_list

當有一批召回的數據，希望通過接口傳遞進來，可以賦值給 item_list。 item_list 是一個數組，每個 item 是 map object ，item 中必須有 item_id 字段，表示物品的ID。其余都是可選的。 item 中如果包含 score 字段，會當成召回得分處理。其余字段當成 item 屬性進行處理。

complex_type_features

復雜類型的上下文特征需要數組傳遞過來，每個元素包含的內容如下：

使用示例：

1. 傳遞單個值，[{"name":"age", "type":"int", "values":20}, {"name":"sex", "values":"male", "type":"string"}]

2. 傳遞數組[{"name":"list_features", "type":"list<int>", "values":[1,2,3]}]

3. 傳遞map[{"name":"map_features", "type":"map<int,int>", "values":{"1":10,"2":20,"3":30}}], 或者[{"name":"map_features", "type":"map<int,int>", "values":{"1":"10","2":"20","3":"30"}}],

type 支持的類型包括int,int64,float,double,string,list<int>,list<int64>,list<float>,list<double>,list<string>,map<int,int>,map<int,int64>,map<int,float>,map<int,double>,map<int,string>,map<string,int>,map<string,int64>,map<string,float>,map<string,double>,map<string,string>,map<int64,int>,map<int64,int64>,map<int64,float>,map<int64,double>,map<int64,string>

注：傳遞上下文中， complex_type_features 和 features 可以同時使用。

接口返回

items 條目具體說明如下：

錯誤碼說明

接口調用

通過curl命令調用

如果需要本地通過curl命令請求引擎服務，需要先在EAS控制臺找到對應服務的請求地址和token，如下圖：

在服務詳情中點擊查看調用信息，即可彈出調用信息。

curl -X 'POST' -v \
'http://12*****.vpc.hangzhou.pai-eas.aliyuncs.com/api/predict/test/api/rec/feed' \
-H 'Authorization:YmRjZThkM2Z*****************TU5Mw==' \
-d '{
"uid":"13579",
"size":10,
"scene_id":"home_feed",
}'

返回數據

{
  "code":200,
  "msg":"success",
  "request_id":"e332fe9c-7d99-45a8-a047-bc7ec33d07f6",
  "size":10,
  "experiment_id":"",
  "items":[
    {
      "item_id":"248791390",
      "score":0.9991594902203332,
      "retrieve_id":"mock_recall"
    }
  ]
}

通過PAI-Rec診斷工具調用

如果您是通過PAI-Rec控制臺服務管理部署的服務，可以直接使用診斷工具來調試推薦結果，如下圖：

您需要選擇對應服務、環境，路由信息選擇/api/rec/feed；

物品表：如果您有item的詳情表，這里也可以選擇，會將item的詳情和返回的數據進行關聯；

請求數據：會展示您最近一段時間的請求參數，也可以手動填寫。

如下圖所示，選擇和填寫好相關參數，點擊診斷即可獲得推薦結果。