基础信息
查看接口基本信息和返回格式
接口描述
品赞代理账号自动化工具。支持每周签到领余额、查询余额/累计消耗/等级、查询用户信息,以及代理IP白名单的查询、添加、删除。
七日请求统计
接口地址
https://api.yunmge.com/api/ipzancom
请求方式
返回方式
返回预览
{
"code": 200,
"msg": "签到成功",
"data": {
"signin_time": "2026-11-15 21:06:20",
"last_signin": "",
"next_signin": "2026-11-22 21:06:21",
"balance": 63.0555,
"bonus": 63.0555
}
}
计费标准
了解接口计费方式和套餐价格
接口类型
免费接口:本接口对所有用户免费开放,每日有一定免费调用次数,超出后可继续使用或升级会员。
计费方式
QPS限制
每分钟最多5次请求,每秒最多1次请求
每分钟最多60次请求,每秒最多5次请求
每日请求次数
普通用户不限制每日请求次数
会员用户不限制每日请求次数
计费规则
安全认证
了解接口的认证方式和访问凭证管理
实名认证
本接口对所有用户开放,无需实名认证即可访问
认证方式
通过 HTTP Header 传递认证信息
通过 URL 参数传递认证信息
Token 管理
登录账户
使用您的账号密码登录平台,获取用户凭证
获取 Token
即可查看你的 Token 密钥
更换 Token
进入个人中心,点击「更换Token」,系统将生成新的 Token 密钥
保存 Token
请妥善保管您的 Token 密钥,泄露时请立即更换
Token 怪谈
安全建议
- 定期更换密钥,建议每 90 天更新一次
- 发现密钥泄露,请立即在个人中心「更换」该密钥
- 不要将密钥硬编码在代码中,使用环境变量存储
参数文档
了解接口的请求参数和响应字段说明
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 可选值 | 说明 |
|---|---|---|---|---|---|
token |
string | 否 | 无 | 登录后显示你的请求token | 平台请求 token,可选;不传按游客额度调用 |
type |
string | 是 | 无 | signin | 功能模块 signin=签到/余额 whitelist=IP白名单 |
action |
string | 是 | 无 | signin | 具体操作 type=signin:signin签到 / balance余额 / info用户信息 type=whitelist:list查询 / add添加 / del删除 |
phone |
string | 是 | 无 | 无 | 品赞账号注册手机号 |
password |
string | 是 | 无 | 无 | 品赞账号登录密码,区分大小写,末尾符号也要完整传入 |
ip |
string | 否 | 无 | 无 | IP 地址 type=whitelist 且 action=add/del 时必填 |
remarks |
string | 否 | 无 | 无 | 备注 type=whitelist 且 action=add 时可选 |
响应参数
| 字段名 | 类型 | 说明 |
|---|---|---|
code
|
int | 业务状态码 200=成功 201=失败 |
msg
|
string | 结果说明 |
data
|
object | 业务数据,随 type/action 变化 |
|
│
├─
signin_time
|
string | 签到成功时间(action=signin) |
|
│
├─
last_signin
|
string | 上一次签到时间 |
|
│
├─
next_signin
|
string | 下次可签到时间 |
|
│
├─
balance
|
float | 当前余额(元) |
|
│
├─
bonus
|
float | 赠送余额(元) |
|
│
├─
bonus_amount
|
float | 赠送余额(action=balance) |
|
│
├─
real_amount
|
float | 充值余额 |
|
│
├─
total_consume
|
float | 累计消费(元) |
|
│
├─
level
|
int | 账号等级 |
|
│
├─
exp_current
|
int | 当前等级经验 |
|
│
├─
exp_needed
|
int | 升级所需总经验 |
|
│
├─
exp_to_next
|
int | 距下一级还差经验 |
|
│
├─
total_extract_ip
|
int | 累计提取 IP 数 |
|
│
├─
today_extract_ip
|
int | 今日提取 IP 数 |
|
│
├─
phone
|
string | 绑定手机号(action=info) |
|
│
├─
user_id
|
string | 品赞用户 ID |
|
│
├─
register_time
|
string | 注册时间 |
|
│
├─
certify_status
|
int | 实名认证状态 |
|
│
├─
popularize_id
|
string | 推广 ID |
|
│
├─
total
|
int | 白名单条数(action=list) |
|
│
├─
list
|
array | 白名单列表 |
|
│
├─
│├ ip
|
string | 已加入的 IP |
|
│
├─
│├ remarks
|
string | 备注 |
|
│
└─
│├ time
|
string | 加入白名单的时间 |
│└ product
|
string | 所属套餐名 |
状态码
了解接口返回的状态码含义及处理方式
接口状态码
| 状态码 | 说明 |
|---|---|
200 |
请求成功 |
201 |
请求失败(登录失败 / 参数缺失 / 已领取 / 上游返回错误) |
服务器状态码
| 状态码 | 说明 |
|---|---|
500 |
服务器错误 |
501 |
请求接口不存在 |
502 |
请求接口已下架 |
503 |
请求接口维护中 |
504 |
缺少请求token参数 |
505 |
请求token不存在 |
506 |
请求token已被封禁 |
507 |
请求token额度不足 |
508 |
今日请求token已达上限 |
509 |
请求ip不在token白名单内 |
510 |
请求token无权使用当前接口 |
511 |
接口请求频率过高,请稍后再试 |
512 |
该接口未开启在线测试功能 |
513 |
今日在线测试次数已达上限 |
514 |
今日该接口请求次数已达上限 |
515 |
该接口为会员专属接口,请携带会员token |
516 |
该接口为会员专属接口,请开通会员 |
517 |
接口请求过于频繁,已被临时限制 |
518 |
该接口需要实名认证,请先完成实名认证 |
519 |
当前Token今日请求次数已达上限 |
520 |
当前Token已被禁止使用 |
521 |
请求token余额不足 |
522 |
请求token额度和余额均不足 |
530 |
接口服务异常,请稍后再试 |
531 |
接口响应超时,请稍后再试 |
532 |
接口暂时不可用,请稍后再试 |
533 |
接口配置异常 |
534 |
请求参数错误,请检查后重试 |
535 |
接口返回数据异常 |
在线测试
在线调试接口,实时查看响应结果
返回结果
等待请求...
等待请求...
示例代码
查看多种编程语言的接口调用示例
/**
* API请求DEMO-PHP
*
* 本demo支持GET与POST请求。
*/
//你申请的token密钥
$API_TOKEN = 'YOUR_TOKEN';
//API接口地址
$API_URL = 'https://api.yunmge.com/api/ipzancom';
$get_post_data = array(
'token' => 'YOUR_TOKEN',
'type' => '无',
'action' => '无',
'phone' => '无',
'password' => '无',
'ip' => '无',
'remarks' => '无',
);
/*发起请求API接口:
第1个参数:API接口地址URL,跟上面的同名变量相对应,无需更改。
第2个参数:API接口参数数组,跟上面的同名变量相对应,无需更改。
第3个参数:请求协议(GET或POST),一般默认GET,部分接口需要POST请求,根据实际情况修改为POST即可。
*/
$resdata = api::send($API_URL, $get_post_data, 'GET/POST'); //发起请求,注意这里要选择接口支持的协议,默认GET,可选POST
//打印请求结果
print($resdata);
///////////////你的业务代码可写在这里处理API返回的数据
/**
* API请求类
*/
class api
{
public static function send($API_URL, $get_post_data, $type)
{
$get_post_data = http_build_query($get_post_data);
$res = self::send_curl($API_URL, $type, $get_post_data, null);
return $res;
}
//封装好的CURL请求函数,支持POST|GET
public static function send_curl($API_URL, $type, $get_post_data)
{
$ch = curl_init();
if ($type == 'POST') {
curl_setopt($ch, CURLOPT_URL, $API_URL);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $get_post_data);
} elseif ($type == 'GET') {
curl_setopt($ch, CURLOPT_URL, $API_URL . '?' . $get_post_data);
}
curl_setopt($ch, CURLOPT_REFERER, $API_URL);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
$resdata = curl_exec($ch);
curl_close($ch);
return $resdata;
}
}
/**
* API请求DEMO-JavaScript
*
* 本demo支持GET与POST请求。
*/
//jQuery-Ajax
$.ajax({
url: 'https://api.yunmge.com/api/ipzancom',
data: {
token: 'YOUR_TOKEN',
type: '无',
action: '无',
phone: '无',
password: '无',
ip: '无',
remarks: '无',
},
type: 'GET/POST', //请求协议(GET或POST),一般默认GET,部分接口需要POST请求,根据实际情况修改为POST即可。
dataType: 'json',
success: function(data) {
console.log(data); //请求成功,输出结果到控制台
},
timeout: 3000, //超时时间
error: function(data) {
console.log('请求失败'); //失败处理
}
});
/**
* API请求DEMO-NodeJs
*
* 本demo支持GET与POST请求。
*/
const https = require('https');
const querystring = require('querystring');
// 定义请求选项
const options = {
hostname: 'api.yunmge.com',
path: '/api/ipzancom',
method: 'GET/POST'
};
// 发送POST请求
const postData = querystring.stringify({
'token': 'YOUR_TOKEN',
'type': '无',
'action': '无',
'phone': '无',
'password': '无',
'ip': '无',
'remarks': '无',
});
const postOptions = {
hostname: 'api.yunmge.com',
path: '/api/ipzancom',
method: 'POST',
headers: {
'Content-Type': 'application/x-www-form-urlencoded',
'Content-Length': Buffer.byteLength(postData)
}
};
const postReq = https.request(postOptions, res => {
console.log(`statusCode: ${res.statusCode}`);
res.on('data', d => {
process.stdout.write(d);
});
});
postReq.on('error', error => {
console.error(error);
});
postReq.write(postData);
postReq.end();
import requests
url = "https://api.yunmge.com/api/ipzancom"
data = {
"token": "YOUR_TOKEN",
"type": "无",
"action": "无",
"phone": "无",
"password": "无",
"ip": "无",
"remarks": "无",
}
response = requests.post(url, data=data)
print(response.json())
package main
import (
"fmt"
"io/ioutil"
"net/http"
"net/url"
"strings"
)
func main() {
apiURL := "https://api.yunmge.com/api/ipzancom"
// POST请求
data := url.Values{}
data.Set("token", "YOUR_TOKEN")
data.Set("type", "无")
data.Set("action", "无")
data.Set("phone", "无")
data.Set("password", "无")
data.Set("ip", "无")
data.Set("remarks", "无")
resp, err := http.Post(apiURL, "application/x-www-form-urlencoded", strings.NewReader(data.Encode()))
if err != nil {
fmt.Println("请求失败:", err)
return
}
defer resp.Body.Close()
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLEncoder;
public class ApiRequest {
public static void main(String[] args) {
try {
String apiUrl = "https://api.yunmge.com/api/ipzancom";
URL url = new URL(apiUrl);
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("POST");
conn.setDoOutput(true);
// 构建POST参数
StringBuilder postData = new StringBuilder();
postData.append("token=").append(URLEncoder.encode("YOUR_TOKEN", "UTF-8"));
postData.append("&"); postData.append("type=").append(URLEncoder.encode("无", "UTF-8"));
postData.append("&"); postData.append("action=").append(URLEncoder.encode("无", "UTF-8"));
postData.append("&"); postData.append("phone=").append(URLEncoder.encode("无", "UTF-8"));
postData.append("&"); postData.append("password=").append(URLEncoder.encode("无", "UTF-8"));
postData.append("&"); postData.append("ip=").append(URLEncoder.encode("无", "UTF-8"));
postData.append("&"); postData.append("remarks=").append(URLEncoder.encode("无", "UTF-8"));
byte[] postDataBytes = postData.toString().getBytes("UTF-8");
conn.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
conn.setRequestProperty("Content-Length", String.valueOf(postDataBytes.length));
try (OutputStream os = conn.getOutputStream()) {
os.write(postDataBytes);
}
BufferedReader reader = new BufferedReader(new InputStreamReader(conn.getInputStream()));
String line;
StringBuilder response = new StringBuilder();
while ((line = reader.readLine()) != null) {
response.append(line);
}
reader.close();
System.out.println(response.toString());
} catch (Exception e) {
e.printStackTrace();
}
}
}
using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Threading.Tasks;
class Program {
static async Task Main() {
string apiUrl = "https://api.yunmge.com/api/ipzancom";
using (HttpClient client = new HttpClient()) {
// POST请求
var formData = new Dictionary<string, string> {
{ "token", "YOUR_TOKEN" },
{ "type", "无" },
{ "action", "无" },
{ "phone", "无" },
{ "password", "无" },
{ "ip", "无" },
{ "remarks", "无" },
};
var content = new FormUrlEncodedContent(formData);
HttpResponseMessage response = await client.PostAsync(apiUrl, content);
string result = await response.Content.ReadAsStringAsync();
Console.WriteLine(result);
}
}
}
/**
* API请求DEMO-C
*
* 本demo支持GET与POST请求。
* 需要安装libcurl库
*/
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <curl/curl.h>
// API地址
const char* url = "https://api.yunmge.com/api/ipzancom";
// POST请求
void postRequest(CURL* curl) {
CURLcode res;
const char* postData = "token=YOUR_TOKEN&type=%E6%97%A0&action=%E6%97%A0&phone=%E6%97%A0&password=%E6%97%A0&ip=%E6%97%A0&remarks=%E6%97%A0";
curl_easy_setopt(curl, CURLOPT_URL, url);
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, postData);
res = curl_easy_perform(curl);
if(res != CURLE_OK) {
fprintf(stderr, "curl_easy_perform() failed: %s\n", curl_easy_strerror(res));
}
}
int main() {
CURL* curl = curl_easy_init();
if(curl) {
postRequest(curl); curl_easy_cleanup(curl);
}
return 0;
}
/**
* API请求DEMO-C++
*
* 本demo支持GET与POST请求。
* 需要安装libcurl库
*/
#include <iostream>
#include <string>
#include <curl/curl.h>
int main() {
CURL* curl = curl_easy_init();
if(curl) {
std::string apiUrl = "https://api.yunmge.com/api/ipzancom";
// POST请求
std::string postData = "token=YOUR_TOKEN&type=%E6%97%A0&action=%E6%97%A0&phone=%E6%97%A0&password=%E6%97%A0&ip=%E6%97%A0&remarks=%E6%97%A0";
curl_easy_setopt(curl, CURLOPT_URL, apiUrl.c_str());
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, postData.c_str());
CURLcode res = curl_easy_perform(curl);
if(res != CURLE_OK) {
std::cerr << "curl_easy_perform() failed: " << curl_easy_strerror(res) << std::endl;
}
curl_easy_cleanup(curl);
}
return 0;
}
.版本 2
.支持库 spec
.子程序 _启动子程序
.局部变量 url, 文本型
.局部变量 data, 文本型
.局部变量 result, 文本型
url = "https://api.yunmge.com/api/ipzancom"
data = "token=YOUR_TOKEN&type=%E6%97%A0&action=%E6%97%A0&phone=%E6%97%A0&password=%E6%97%A0&ip=%E6%97%A0&remarks=%E6%97%A0"
result = 网页_访问 (url, 1, data, , , , , , , , , )
调试输出 (result)
常见问题
查找常见问题的解决方案
1. 这个接口能做什么
把品赞代理账号的三件事自动化:每周签到领余额、查询账号资产与消耗、维护代理 IP 白名单。你只需要传入自己的品赞账号手机号和密码,登录、取 token、刷新 token 都由接口完成。
2. type 和 action 怎么组合
| type | action | 作用 |
|---|---|---|
| signin | signin | 领取本周签到奖励 |
| signin | balance | 余额、累计消费、等级、累计/今日提取 IP 数 |
| signin | info | 手机号、用户 ID、注册时间、实名状态 |
| whitelist | list | 查询当前白名单 |
| whitelist | add | 添加 IP(需传 ip,可选 remarks) |
| whitelist | del | 删除 IP(需传 ip) |
3. phone 和 password 要传对
密码区分大小写,末尾的符号、空格也算密码的一部分,复制时要完整。密码错误时返回 201 登录失败,请检查账号密码;上游对「账号不存在」和「密码错误」返回的是同一句提示,所以看到这个错误先自己登录官网确认一次。
4. 签到规则
品赞是每 7 天可领一次。成功后 data.next_signin 就是下次可领取时间;重复调用会返回 201 您已领取过了 请一周后再次领取,并带上上次签到时间,不会扣任何东西。建议每天晚上跑一次,失败也没关系。
5. 白名单相关
白名单有数量上限(常见 10 条),满了再 add 会被上游拒绝,需要先 del 掉不用的 IP。白名单修改后立即生效,代理提取时不需要再带账号密码。如果服务器出口 IP 会变(比如动态宽带),建议配合定时任务在 IP 变化时调用 add。
6. 常见返回码
| 返回 | 含义 | 处理建议 |
|---|---|---|
| 200 | 成功 | — |
| 201 登录失败 | 账号或密码不对 | 核对密码(含末尾符号) |
| 201 请传入 phone 和 password | 参数缺失 | 补齐参数 |
| 201 请传入 type / action | 未指定模块或操作 | 按第 2 节组合传值 |
| 201 您已领取过了 | 本周已签到 | 按 next_signin 再来 |
| 201 请传入 ip 参数 | 白名单操作缺 ip | 传 ip |
| 201 添加失败 / 删除失败 | 上游拒绝(多为白名单已满或 IP 不存在) | 先 list 查当前白名单 |
7. 安全提醒
调用时会把品赞账号密码发给接口,请不要把密码写在网页前端或公开仓库里;建议在服务端调用,并且不要把带密码的请求 URL 贴到公开地方(GET 请求的参数会进日志)。如果只是自己用,可以考虑在账号侧单独设置一个低权限的提取密钥。