广告请求接口

⏱️ 接口信息

功能： 请求广告展示和返回广告数据

Content-Type： application/json(POST)或application/x-www-form-urlencoded(GET)

接口地址： api/ad_request.php

📝 请求参数

参数名	类型	必填	范围/格式	说明
appid	string	✅	16位字符串	项目唯一标识，在用户中心获取
appkey	string	✅	64位字符串	项目密钥，在用户中心获取
token	string	✅	32位MD5	验证令牌，计算方式见下方
ukey	string	✅	-	用户密钥，在用户资料页面设置
type	int	✅	0-3	广告类型：0=开屏，1=插屏，2=横幅，3=视频
sk	int	✅	3-60	广告有效时间段(秒)，超时后需重新请求
t	string	✅	Unix时间戳	请求时间戳(秒)，用于防重放攻击
posid	string	❌	-	指定广告商UID，为空则系统智能分配

警告

请记住，您的API访问令牌是机密信息！ 将您的访问令牌视为密码类似的敏感凭据，采取相同的保护措施。

不要与他人分享它，也不要在任何客户端代码（浏览器、应用程序）中公开它。如果请求必须通过您自己的后端服务器，从环境变量或密钥管理服务中安全加载您的 API 访问令牌。

用户必须先在个人资料页面设置密钥才能使用API。

🔐 Token生成规则

算法： MD5(appid + appkey + t + ukey)

提醒

用户必须先在个人资料页面设置密钥(ukey)才能使用API。

Token生成示例：

假设：
appid = 3f518e664c62c93d
appkey = bf443925288cc245e3b4da8a451f8192807a23099e4c0e2c44ab74860be58bcb
t = 1692000000
ukey = a1b2c3d4e5f6g7h8i9j0

组合字符串 = 3f518e664c62c93dbf443925288cc245e3b4da8a451f8192807a23099e4c0e2c44ab74860be58bcb1692000000a1b2c3d4e5f6g7h8i9j0
token = MD5(组合字符串) = 8b7a6c5d4e3f2g1h0i9j8k7l6m5n4o3

🌐 请求示例

GET请求示例：

POST请求示例：

📊 响应格式

✅ 成功响应 (error: 1000):

{
  "error": 1000,
  "m": "广告获取成功",
  "ad": {
    "eid": "ad_689c209bd210f0.59912595",
    "adid": "63",
    "title": "软件分享标题1",
    "content": "广告描述内容，支持HTML格式",
    "aurl": "https://example.com/target-url",
    "vd": "http://127.0.0.3/uploads/vertical_image.png",
    "td": "http://127.0.0.3/uploads/horizontal_image.png",
    "icon": "http://127.0.0.3/uploads/icon.png",
    "video": "http://127.0.0.3/uploads/video.mp4",
    "videoti": "30",
    "sp_viewti": "5",
    "ab_viewti": "3"
  }
}

❌ 错误响应:

{
  "error": -1001,
  "m": "Token验证失败，请检查appid、appkey和时间戳",
  "ad": ""
}

⚠️ 常见错误码

错误码	说明	解决方案
-1001	Token验证失败	检查appid、appkey和时间戳计算
-1002	暂无匹配广告	稍后重试或联系管理员
-1003	参数格式错误	检查参数类型和范围
-1004	请求频率过高	降低请求频率，建议间隔3秒以上
-1005	时间戳过期	时间戳与服务器时间差超过5分钟

更多错误码请查看错误码对照表来获取更多帮助。

⏱️ 接口信息#

📝 请求参数#

🔐 Token生成规则#

🌐 请求示例#

📊 响应格式#

⚠️ 常见错误码#

⏱️ 接口信息

📝 请求参数

🔐 Token生成规则

🌐 请求示例

📊 响应格式

⚠️ 常见错误码