概述

collections 允许集中运行多个请求。每个收集器上你可以添加最多15000个请求( 一次请求是对Product Data API的简单调用 )，账号上最多有10000个收集器。

collections 可以安排每月、每周、每天、每小时运行或者按需求手动运行，可以获取json、json lines 或者 csv格式结果集。当collections完成Rainforect API也可以在你的应用上调用webhook。
注意
Collection & Result Set Expiry

  • 没有做任何操作两个月后，收集器从你的账号删除。也就是说，你必须每两个月做次收集。
  • 结果集可以在14天内下载，所以你的应用程序应该在这14天的窗口期内下载并处理结果集数据。

collection API 创建、更新、删除收集器。也可以用collections API 向收集器添加请求和检索结果集。
注意
collections API是免费的

  • 使用Collections API是免费的，对它的请求不会减少您的计划每月的请求配额。
  • 当您启动一个集合时，集合内的请求将按照通过Product Data API发出的请求收费。所以一个包含200个请求的集合，运行一次，将花费200积分。

Rainforest API 仪表盘还为收集器提供了可视化编辑器，在通过Collections API以编程方式创建集合之前，它是熟悉集合中的关键概念的一种很好的方式。

Collections 术语

帮助你开始，在使用Rainforest API Collections会碰到这些术语：

collection

  • 你的账号在任何时间可以创建10000个收集器。一个收集器支持多个(上限15000个请求)请求。
  • 一个收集器可以有个计划表，可以设置成自动或者手动。
  • 当一个集合启动时，它的请求将通过Rainforest API Product Data API运行，并生成一个结果集。
  • 当有新的结果集生成时collections可以通过email或者webhook POST通知你。
  • rainforest API将自动删除没有运行2个月的集合。


如果你开始多个收集器，他们放入队列中有序地执行。对于控制订单的执行，你可以设置每个收集器优先级**。先启动优先级较高的收集器。更多关于优先级。

Request

一个收集器可以容纳上限15000个请求( 当添加include_html=true的请求是500个 )。请求只是与产品数据API的单个请求相关的参数集合。

Result Set

  • 当收集器完成时（所有的请求已经被计算过），结果集生成。
  • 你可以用collections API 检索结果集，用在你的应用程序中。
  • Rainforest API 结果集保存14天，所以你可以在14天的窗口期下载。

**
Rainforest API 提供json 、csv格式的结果集。

**