# 监控任务的最新广告商品

## 接口信息

- **接口名称**: 监控任务的最新广告商品
- **请求方法**: POST
- **接口地址**: `open-api/v1/monitor/data`
- **接口路径**: `/v3/api/ad-monitor-task/latest-products`
- **接口描述**:
    - 获取监控任务中最新的广告商品数据
    - 支持限制返回商品数量
    - 提供最新的商品监控信息
    - 价格说明: `免费`

**请求头:**

- Content-Type: application/json
- Accept: application/json

## 请求参数

### 请求结构

| 参数名 | 类型   | 描述                        | 示例                                | 必填 | 默认值 |
| ------ | ------ | --------------------------- | ----------------------------------- | ---- | ------ |
| key    | string | 用户申请的外部 api 请求 key | "your_api_key_here"                 | 是   |        |
| uri    | string | 接口路径                    | "/v3/api/ad-monitor-task/latest-products" | 是   |        |
| params | object | 接口入参对象                | 见参数列表                          | 是   |        |

### 请求体参数 (params 对象)

| 参数名               | 类型      | 必填    | 描述              |
|-------------------|---------|-------|-----------------|
| task_id           | String  | true  | 任务id            |
| limit           | integer | false | 查询数量限制(默认6)     |


### 请求示例

```bash
curl -X POST "https://www.pipispy.com/open-api/v1/monitor/data" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "key": "your_api_key_here",
    "uri": "/v3/api/ad-monitor-task/latest-products",
    "params": {
      "task_id": "68f98898850c5345a4c87e66"
    }
  }'
```

## 响应参数

### 响应体结构

```json
{
  "code": 200,
  "message": "success",
  "data": {},
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 0,
  "fail": false,
  "success": true
}
```

### 响应字段说明

| 字段名    | 类型    | 描述                     |
| --------- | ------- | ------------------------ |
| code      | Integer | 响应状态码，200 表示成功 |
| message   | String  | 响应消息                 |
| data      | Object  | 响应数据                 |
| version   | String  | API 版本                 |
| timestamp | String  | 响应时间戳               |
| sign      | String  | 响应签名                 |
| remaining_credits | Long    | 当前请求后的剩余可用积分 |
| consumed_credits  | Long    | 本次请求消耗的积分 |
| success   | Boolean | 请求是否成功             |
| fail      | Boolean | 请求是否失败             |

### 响应结果信息字段

| 字段名   | 类型                 | 描述             |
|-------|--------------------|----------------|
| data  | array [object {5}] | 数据             |
| data.product_id | string             | 商品ID           |
| data.product_url | string             | 产品地址           |
| data.product_name | string             | 商品名称           |
| data.product_image_url | string             | 商品图片URL        |
| data.ad_start_date | integer            | 广告开始日期，时间戳，单位s |


## 响应示例

```json
{
  "code": 200,
  "message": "success",
  "data": {
    "data": [
      {
        "product_url": "https://atoleajewelry.com/collections/waterproof-jewelry/products/initial-birthstone-charm-necklace",
        "product_id": "016ffe77783899d006894f28ab736904",
        "product_image_url": "https://fb-cdn.pipiads.com/images/pimg_e20d63ffa1cc4f3512f02.png",
        "ad_start_date": 1753340400,
        "product_name": "Initial & Birthstone Charm Necklace"
      },
      {
        "product_url": "https://atoleajewelry.com/products/wave-bracelet?utm_content=Facebook_UA&utm_source=facebook&variant=35676557574312",
        "product_id": "cd588be1dcdf69d195e0c40ee5aaa912",
        "product_image_url": "https://fb-cdn.pipiads.com/images/pimg_a163906dd1d756d701123.png",
        "ad_start_date": 1747897200,
        "product_name": "Wave Bracelet"
      },
      {
        "product_url": "https://atoleajewelry.com/products/wave-ring?utm_content=Facebook_UA&utm_source=facebook&variant=35675080949928",
        "product_id": "6e22078c8e5c62c2b289a659c416691a",
        "product_image_url": "https://fb-cdn.pipiads.com/images/pimg_4d798a9d7a717596bdf2b.png",
        "ad_start_date": 1747897200,
        "product_name": "Wave Ring"
      },
      {
        "product_url": "https://atoleajewelry.com/products/whale-tail-necklace?utm_content=Facebook_UA&utm_source=facebook&variant=35678917034152",
        "product_id": "994f3ac901bd98555ce6efc13aaebff4",
        "product_image_url": "https://fb-cdn.pipiads.com/images/pimg_fda32dd4d136fefc687e0.png",
        "ad_start_date": 1747897200,
        "product_name": "Whale Tail Necklace"
      },
      {
        "product_url": "https://atoleajewelry.com/products/summer-night-earrings?utm_content=Facebook_UA&utm_source=facebook&variant=35675114176680",
        "product_id": "2bdae269a2ec12bb6c6141772f3be055",
        "product_image_url": "https://fb-cdn.pipiads.com/images/pimg_845004d97b0143d774ed4.png",
        "ad_start_date": 1747897200,
        "product_name": "\"Summer Night\" Earrings"
      }
    ]
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 0,
  "fail": false,
  "success": true
}
```

## 错误码说明

| 错误码 | 描述           |
| ------ | -------------- |
| 200    | 成功           |
| 400    | 请求参数错误   |
| 500    | 服务器内部错误 |