# App 开发者详情接口

## 接口信息

- **接口名称**: 获取 App 开发者详情
- **请求方法**: POST
- **接口地址**: `/open-api/v1/data`
- **接口路径**: `/v3/api/open/app-dev/detail`
- **接口描述**: 根据开发者 ID 获取 App 开发者详细信息
- **价格说明**: 详情接口计费规则： 基础费用：1 credit/次。 免费访问条件（满足其一即可）： 该ID在3天内已获取过详情；该ID在3天内出现在您的榜单列表查询结果中。

**请求头:**

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

## 请求参数

### 请求结构

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

### 参数列表 (params 对象)

| 参数名 | 类型   | 必填 | 描述          |
| ------ | ------ | ---- | ------------- |
| id     | String | 是   | App 开发者 ID |

### 请求示例

```bash
curl -X POST "https://www.pipispy.com/open-api/v1/data" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "key": "your_api_key_here",
    "uri": "/v3/api/open/app-dev/detail",
    "params": {
      "id": "507f1f77bcf86cd799439011"
    }
  }'
```

## 响应参数

### 响应体结构

```json
{
  "code": 200,
  "message": "success",
  "data": {
    // App开发者详情信息
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 1,
  "success": true,
  "fail": false
}
```

### 响应字段说明

#### 标准响应字段

| 字段名 | 类型 | 描述 |
| ------ | ---- | ---- |
| remaining_credits | Long    | 当前请求后的剩余可用积分 |
| consumed_credits  | Long    | 本次请求消耗的积分 |

##### 主要响应字段

| 字段名                        | 类型    | 描述                            |
| ----------------------------- | ------- | ------------------------------- |
| id                            | String  | App 开发者唯一标识 ID           |
| icon                          | String  | App 开发者图标 URL              |
| name                          | String  | App 开发者名称                  |
| url                           | String  | App 开发者商店链接              |
| ad_platform_list              | Array   | 广告平台列表                    |
| app_system                    | Array   | App 系统列表 (如: android, ios) |
| all_data_count                | Long    | 总数据数量                      |
| app_count                     | Long    | App 数量                        |
| app_download_count            | Long    | 总 App 下载次数                 |
| app_comment_count             | Long    | 总 App 评论次数                 |
| revenue                       | Object  | 收入信息对象                    |
| first_time                    | Long    | 首次时间 (时间戳)               |
| found_time                    | Long    | 首次发现时间 (时间戳)           |
| latest_found_time             | Long    | 最新发现时间 (时间戳)           |
| last_month_app_download_count | Long    | 上月 App 下载次数               |
| region                        | Array   | 目标地区列表                    |
| is_collection                 | Boolean | 是否已收藏                      |

##### 收入信息字段 (revenue)

| 字段名   | 类型   | 描述                      |
| -------- | ------ | ------------------------- |
| unit     | String | 收入单位 (如: "cent")     |
| currency | String | 货币代码 (如: "USD")      |
| type     | String | 收入类型 (如: "currency") |
| value    | Long   | 收入数值                  |

### 响应示例

```json
{
  "code": 200,
  "message": "success",
  "data": {
    "id": "7318974570271626660",
    "icon": "https://cdn-app.pipispy.com/0b6854aa841473b2657939f3221880f0.jpg",
    "name": "Knowunity",
    "url": "https://play.google.com/store/apps/dev?id=7318974570271626660",
    "ad_platform_list": ["tiktok"],
    "app_system": ["android"],
    "all_data_count": 95,
    "app_count": 1,
    "app_download_count": 13506812,
    "app_comment_count": 0,
    "revenue": {
      "unit": "cent",
      "currency": "USD",
      "type": "currency",
      "value": 4000000
    },
    "first_time": 1623380257,
    "found_time": 1623380257,
    "latest_found_time": 1752198253,
    "last_month_app_download_count": 500000,
    "region": [
      "DE",
      "PT",
      "IT",
      "GR",
      "MX",
      "FR",
      "ES",
      "BR",
      "CZ",
      "GB",
      "PL",
      "RO",
      "US",
      "TR"
    ],
    "is_collection": false
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 1,
  "success": true,
  "fail": false
}
```

## 错误码说明

| 错误码 | 描述                      |
| ------ | ------------------------- |
| 200    | 成功                      |
| 400    | 请求参数错误              |
| 401    | 未授权 - API 密钥无效     |
| 404    | 未找到 - App 开发者不存在 |
| 500    | 服务器内部错误            |