IP探针平台 - API接口文档

文档说明

本文档提供IP探针平台核心API的详细说明，包括邮箱接口、探针接口和贴吧接口。所有接口均需通过token验证身份，请确保请求格式正确并携带有效凭证。token永久有效，通过用户中心获取。

文档版本：v1.0.0

更新日期：2025-07-17

接口列表

邮箱接口

用于获取邮箱相关信息

POST /api/ipark_email

请求参数

参数名	类型	必填	描述
token	string	是	用户身份令牌（从用户中心获取）
email	string	是	需要查询的邮箱地址

请求示例

{
  "token": "用户中心的token",
  "email": "example@domain.com"
}
                    

成功响应 (200)

{
 {
    "email": "10001@qq.com",
    "is_vip": true,
    "message": "✅ 邮件已发送",
    "remaining_count": 999,
    "status": "success",
    "used_count": 1
}
}
                    

错误响应 (400)

{
  "status": "error",
  "message": "❌ 无效的邮箱格式",
  "data": null
}
                    

探针接口

用于获取IP探针相关信息

POST /api/ipark

请求参数

参数名	类型	必填	描述
token	string	是	用户身份令牌（从用户中心获取）

请求示例

{
  "token": "用户中心的token",
}
                    

成功响应 (200)

{
    {
    "daily_limit": 999,
    "is_friend": true,
    "is_vip": true,
    "message": "✅ 卡片已发送",
    "remaining_count": 999,
    "status": "success",
    "used_group": 931871516,
    "uuid": "32ce2f0c-2f89-49ac-b2a4-e80067297fa2"
    }
}
                    

错误响应 (400)

{
  "status": "error",
  "message": "❌ 无效的TOKEN",
  "data": null
}
                    

贴吧接口

用于获取贴吧相关信息

POST /api/ipark_tieba

请求参数

参数名	类型	必填	描述
token	string	是	用户身份令牌（从用户中心获取）
tieba_name	string	是	需要查询的贴吧名称
page	integer	否	页码，默认为1
page_size	integer	否	每页数量，默认为20，最大为50

请求示例

{
  "token": "用户中心的token",
  "tieba_name": "JAVA",
  "page": 1,
  "page_size": 20
}
                    

成功响应 (200)

{
  "status": "success",
  "message": "✅ 查询成功",
  "data": {
    "tieba_name": "JAVA",
    "total_posts": 12345,
    "total_pages": 618,
    "current_page": 1,
    "page_size": 20,
    "posts": [
      {
        "post_id": "123456789",
        "title": "JAVA新手入门教程",
        "author": "example_user",
        "content": "大家好，我是JAVA新手，分享一下我的学习经验...",
        "reply_count": 56,
        "view_count": 1234,
        "create_time": "2025-07-17T15:30:22.123456",
        "last_reply_time": "2025-07-17T18:45:11.678901"
      },
      {
        "post_id": "987654321",
        "title": "Python爬虫实战",
        "author": "spider_master",
        "content": "本文将介绍如何使用Python编写高效的爬虫程序...",
        "reply_count": 89,
        "view_count": 2345,
        "create_time": "2025-07-16T10:20:33.456789",
        "last_reply_time": "2025-07-17T19:10:22.345678"
      }
    ]
  }
}
                    

错误响应 (404)

{
  "status": "error",
  "message": "❌ 未找到指定的贴吧",
  "data": null
}
                    

Token 说明

什么是token？

token是用户身份的唯一凭证，通过用户中心获取，用于验证API请求的合法性。所有接口均需在请求中携带有效token，否则会被拒绝访问。

token有效期

token永久有效，除非用户主动注销或管理员撤销权限。请妥善保管，不要分享给他人。

如何获取token？

通过用户中心接口获取：

{
  "user_id": 123456,
  "app_id": "your_app_id",
  "secret_key": "your_secret_key"
}

// 响应
{
  "status": "success",
  "message": "获取token成功",
  "data": {
    "token": "ds232xawe23213xm1onx",
    "expire_time": "永久有效",
    "user_id": 123456
  }
}
                        

错误码说明

状态码	说明	常见原因
200	请求成功	接口正常处理并返回数据
400	请求参数错误	缺少必填参数、参数格式错误
401	身份验证失败	token无效、token已被撤销
403	权限不足	无访问权限、超出使用限制
404	资源不存在	请求的资源不存在
500	服务器错误	服务器内部异常，请联系技术支持