相似产品模板项目技术文档

本文档将详细介绍如何安装、使用以及调用相似产品模板项目（Similar Product Template）的API。

1. 安装指南

在开始安装之前，请确保您的系统中已经安装了以下依赖项：

• Apache PredictionIO
• Scala
• SBT（Scala Build Tool）

安装步骤：

1. 克隆项目仓库：

   git clone https://github.com/apache/predictionio-templates.git
   cd predictionio-templates/similarproduct
   

2. 运行SBT命令以构建项目：

   sbt assembly
   

3. 初始化PredictionIO：

   pio init --template similarproduct
   

4. 配置PredictionIO环境：

   pio config-set
   

5. 导入示例数据：

   python data/import_eventserver.py --access_key <your_access_key>
   

   请替换<your_access_key>为您自己的Access Key。

2. 项目的使用说明

在项目构建完成后，您可以使用以下命令启动PredictionIO服务器：

pio server

服务器启动后，您可以通过以下方式查询相似产品：

curl -H "Content-Type: application/json" \
-d '{ "items": ["i1", "i3", "i10", "i2", "i5", "i31", "i9"], "num": 10 }' \
http://localhost:8000/queries.json

您还可以根据需要添加更多参数，例如分类或黑白名单：

curl -H "Content-Type: application/json" \
-d '{
  "items": ["i1", "i3", "i10", "i2", "i5", "i31", "i9"],
  "num": 10,
  "categories": ["c4", "c3"]
}' \
http://localhost:8000/queries.json

curl -H "Content-Type: application/json" \
-d '{
  "items": ["i1", "i3", "i10", "i2", "i5", "i31", "i9"],
  "num": 10,
  "whiteList": ["i21", "i26", "i40"]
}' \
http://localhost:8000/queries.json

curl -H "Content-Type: application/json" \
-d '{
  "items": ["i1", "i3", "i10", "i2", "i5", "i31", "i9"],
  "num": 10,
  "blackList": ["i21", "i26", "i40"]
}' \
http://localhost:8000/queries.json

3. 项目API使用文档

以下是与相似产品模板项目相关的API：

查询相似产品

• URL：http://localhost:8000/queries.json

• 方法：POST

• 请求头：Content-Type: application/json

• 请求体：

  {
    "items": ["item_id_1", "item_id_2", ...],
    "num": <推荐产品数量>,
    "categories": ["category_1", "category_2", ...],
    "whiteList": ["item_id_1", "item_id_2", ...],
    "blackList": ["item_id_1", "item_id_2", ...]
  }
  

• 响应：JSON格式的相似产品列表

4. 项目安装方式

项目安装方式已在“1. 安装指南”中详细说明，主要包括以下步骤：

1. 克隆项目仓库
2. 运行SBT命令构建项目
3. 初始化PredictionIO
4. 配置PredictionIO环境
5. 导入示例数据

通过遵循以上步骤，您可以成功安装并开始使用相似产品模板项目。