开始

本页描述了使用产品情感洞察API所需的基本知识。

HTTP服务和数据集

产品情感洞察API与传统的“REST”风格API不同，它由两个不同的组件组成，如下所述:

HTTP服务

HTTP服务是指用于请求产品情感洞察数据集的HTTP接口。与HTTP服务的交互是一个多步骤过程，首先请求列出可用清单文件的资源，然后请求所需的清单文件，最后请求清单文件中标识的数据文件。HTTP服务将在工作流程演练教程。

数据集

数据集由压缩格式的数据文件组成，其中包含产品情绪洞察。使用HTTP服务请求数据集。与传统的“REST”风格API不同，这些数据集是定期预计算的。此外，每个数据文件不是表示一个资源，而是包含许多行文本，这些文本可以作为JSON对象进行计算。上的数据集了解更多信息参考页面。

这种混合架构以牺牲一些灵活性为代价来实现速度。例如，我们鼓励您对HTTP服务执行多个并发请求。但是，由于数据集是预先计算的，HTTP服务不提供任何“REST”风格api常用的过滤器或排序选项。

环境

Product Sentiment Insights API支持以下环境:

环境	域	描述
暂存	https://stg.api.bazaarvoice.com	在开发应用程序时使用。
生产	https://api.bazaarvoice.com	在应用程序完成时使用。

这些环境使用不同的API密钥，因此有独立的速率限制。这允许您使用登台环境开发应用程序，而不会损害生产环境的稳定性。但是，这两个环境都将返回生产数据。

版本控制

Product Sentiment Insights API公开了两种版本类型:一种用于HTTP服务，另一种用于数据集。这允许您保留对如何与产品情感洞察API交互的控制，并将您的实现与未来对产品情感洞察API的更改分离，直到您准备好升级。

该表显示了所有版本:

版本	发布日期	弃用日期	状态
HTTP服务版本(标识URL路径的结构、查询字符串参数和标题)
v1	2019-02-01	TBD	最新的
数据集版本(识别产品情感洞察API返回的数据结构)
v1	2019-02-01	TBD	最新的

最新的

这是最新版本。特性开发主要集中在未来的版本上，但是我们可能会执行向后兼容的错误修复。新的应用程序应该使用这个版本．

配置选项

Product Sentiment Insights API支持以下配置选项:

鼓励内容

您可以选择是否在数据集中包含激励内容。奖励内容将默认包含在内。

语言

您可以选择数据集中包含哪些受支持的语言。支持的语言为英语、西班牙语、法语和德语。默认情况下将包括所有受支持的语言。

若要更新这些配置选项的值，请联系Bazaarvoice客户服务中心或您在Bazaarvoice的技术联系人。

数据更新间隔

Product Sentiment Insights API数据在以下时间间隔提供:

时间间隔	清单名称	描述
至少每月一次	完整的	Bazaarvoice将至少每月为所有可用内容生成一次数据集。您应该使用最新的可用数据文件完全替换您的数据存储。这可以确保您的数据存储不会与Bazaarvoice网络不同步。

凭证

Bazaarvoice将提供以下所需的证书:

类型	描述
万能钥匙	每个请求中包含的每个环境的唯一标识符。您将收到两个密钥，一个用于登台，另一个用于生产。
共享的秘密	用于加密访问签名．只有你和Bazaarvoice知道。您将收到两个秘密，一个用于分期，另一个用于生产。

下一个步骤

请求访问到产品情感洞察API。