检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
调用说明 推荐系统提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 父主题： 使用前必读
如何调用API 构造请求 认证鉴权 返回结果
在线服务获得推荐的调用次数如何计算？ RES从全局角度计算在线服务获得推荐的调用次数，不区分每次调用的用户。例如A用户调用请求推荐接口是每秒5次，B用户调用请求推荐接口每秒5次，当A用户和B用户同时调用此接口时，总的获得推荐的调用请求为A用户和B用户之和，即5+5=10。 父主题：
存起来，避免频繁调用。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。 Token可通过调用获取用户Token接口获取，调用本服务API需要
通过调用API重新执行作业 功能介绍 该接口用于重新执行作业。 URI POST /v1/{project_id}/rerun-job 参数说明请参见表1。 表1 URI参数说明 名称 是否必选 类型 说明 project_id 是 String 项目编号，用于资源隔离。获取方法请参见获取项目ID。
通过调用API查询作业详情 功能介绍 该接口用于查询作业详情。 URI GET/v1/{project_id}/jobs/{job_id} 参数说明请参见表1。 表1 URI参数说明 名称 是否必选 类型 说明 project_id 是 String 项目编号，用于资源隔离。获取方法请参见获取项目ID。
体。 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对于获取用户Token接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。 对于获取用户
构造请求 本节介绍REST API请求的组成，并以调用IAM服务的获取用户Token接口说明如何调用API，该API获取用户的Token，Token可以用于调用其他API时鉴权。 您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987
获取项目ID 调用API获取项目ID 项目ID还用通过调用查询指定条件下的项目信息API获取。 获取项目ID的接口为“GET https://{Endpoint}/v3/projects/”，其中{Endpoint}为IAM的终端节点，可以从地区和终端节点获取。接口的认证鉴权请参见认证鉴权。
获取账号ID 在调用接口的时候，部分URL中需要填入账号ID，所以需要先在管理控制台上获取到账号ID。账号ID获取步骤如下： 登录管理控制台。 单击用户名，在下拉列表中单击“我的凭证”。 在“API凭证”页面中查看账号ID。 图1 获取账号ID 父主题： 附录
错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 RES.1001 Basic Error 请求参数（{0}）的值无效 请检查是否有非法的参数值输入。 400 RES.1002 Basic
终端节点 终端节点即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。 推荐系统的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。 表1 推荐系统的终端节点 区域名称 区域 终端节点（Endpoint） 华北-北京四
的，复制接口地址，调用服务。 图2 获取预测接口 通过在线服务详情页面获取接口 登录RES管理控制台，在左侧菜单栏中选择“在线服务”，进入服务列表页面。 单击目标服务名称进入服务详情页面，通过单击预测接口右侧的，复制接口地址，调用服务。 图3 获取预测接口 调用接口 Mozill
以获取该服务的“API接口地址”。单击，复制接口地址，调用服务。 图3 获取预测接口 调用接口 Mozilla、Google都为REST提供了图形化的浏览器插件，发送处理请求消息。 此处以Postman为例，指导您如何通过调用预测接口获取推荐结果。更多接口信息请参见《推荐系统API参考》。
以获取该服务的“API接口地址”。单击，复制接口地址，调用服务。 图3 获取预测接口 调用接口 Mozilla、Google都为REST提供了图形化的浏览器插件，发送处理请求消息。 此处以Postman为例，指导您如何通过调用预测接口获取推荐结果。更多接口信息请参见《推荐系统API参考》。
离线数据源 调用RES之前，您需要准备3种基础数据包并上传至OBS，离线数据源目前支持CSV和JSON。具体数据包请参见表1 基础数据表。 表1 基础数据表 数据类型 表名 用户类数据 用户属性表 物品类数据 物品属性表 行为类数据 用户操作行为表 用户需要自己手工创建整理这些表并存储到OBS上。
在“在线服务”页面，单击目标服务操作列的“启动”完成操作。 开通服务 在线服务创建完成后，默认为开通状态，您可以对“运行中”状态的服务进行正常调用。当您在调用过程中提示“开通”时，需要开通才能正常使用。 您可以对处于“运行中”、“已停止”状态的服务进行“开通”操作。 登录RES管理控制台，
服务”管理页面。 您可以在服务列表直接查看服务的“名称”、“状态”、“调用总次数”、“开通状态”和“服务类型”等。 当服务部署成功：您可以单击服务名称左侧的查看预测接口、ID、在线流程名称、在线流程ID进行调用。 当服务部署失败：您可以单击服务名称左侧的查看失败原因，根据失败原因
通过DLF重新执行作业 推荐系统提供了重新执行作业的API，用来将任务以相同的配置重新执行一次，实现对离线任务生成结果的更新。以固定的周期定时调用此API，可保持结果处于一个较新的状态，以获得更好的推荐结果。 以上功能，我们也可以使用数据治理中心 DataArts Studio，通过拖拽的方式完成配置。具体操作步骤如下：
TPS统计规则为每小时平均TPS，例如每秒调用5次，持续调用1小时，TPS即为5，这一小时按需计费消耗为5*0.95=4.95元。 最终纳入计费的有效TPS值由两部分决定： 配置TPS：客户在场景中配置的在线服务TPS。 说明： 在线服务TPS默认值为5，如果真实调用量不超过5或者没有调用，也会按照基础配置TPS为5来收取基本费用。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
