首页
开发者

代理商 API

将您自己的面板、网站或 Telegram 机器人接入 ClickPop，以您自己的品牌销售服务。请求格式与 SMM 面板脚本通用格式一致，通常几分钟即可完成接入。

POST https://clickpop.ir/api/reseller/v1

仅限 HTTPS
输入表单或 JSON，输出 JSON
价格以土曼计，每 1000
每个密钥每分钟 240 次请求

快速开始

获取密钥在面板中打开“API”并创建密钥，可限制为您的服务器 IP。
将我们添加为供应商在您的面板脚本中将 API 地址设为上方地址并粘贴密钥。
导入服务调用 services，挑选要出售的服务并设置您自己的价格。

请求格式

所有调用都是 POST 到同一地址。参数可用表单（application/x-www-form-urlencoded）或 JSON 发送；响应始终为 UTF-8 JSON。

参数	必填	说明
`key`	是	您的 API 密钥
`action`	是	`services` · `add` · `status` · `refill` · `refill_status` · `cancel` · `balance`

服务列表

action=services

所有在售服务及您的价格。请将列表缓存几分钟，不要每次下单前都请求。

请求

curl -X POST https://clickpop.ir/api/reseller/v1 \
  -d key=YOUR_KEY \
  -d action=services

响应

[
  {
    "service": 1204,
    "name": "Instagram followers — Iranian, high quality, 30-day refill",
    "type": "Default",
    "category": "Instagram — Followers",
    "rate": "48000",
    "min": "100",
    "max": "50000",
    "refill": true,
    "cancel": false,
    "dripfeed": false
  }
]

字段	说明
`service`	服务 ID——在 add 中使用
`rate`	您的价格（每 1000，单位土曼，已含账户折扣）
`min` / `max`	每单允许的数量范围
`refill`	该服务可申请掉量补充
`cancel`	可在开始交付前取消订单

新订单

action=add

参数	必填	说明
`service`	是	服务 ID
`link`	是	主页、帖子或频道链接（https://…）
`quantity`	是	介于该服务的 min 与 max 之间

请求

curl -X POST https://clickpop.ir/api/reseller/v1 \
  -d key=YOUR_KEY \
  -d action=add \
  -d service=1204 \
  -d link=https://instagram.com/yourpage \
  -d quantity=1000

响应

{"order": 10482}

下单时从钱包扣款，未交付部分自动退款。

订单状态

action=status

请求

curl -X POST https://clickpop.ir/api/reseller/v1 \
  -d key=YOUR_KEY \
  -d action=status \
  -d order=10482

响应

{
  "charge": "48000",
  "start_count": "1520",
  "status": "In progress",
  "remains": "380",
  "currency": "IRT"
}

批量查询订单

action=status

最多 100 个订单 ID，用逗号分隔。

请求

curl -X POST https://clickpop.ir/api/reseller/v1 \
  -d key=YOUR_KEY \
  -d action=status \
  -d orders=10482,10483

响应

{
  "10482": {"charge": "48000", "start_count": "1520", "status": "Completed", "remains": "0", "currency": "IRT"},
  "10483": {"error": "Incorrect order ID"}
}

补量

action=refill

适用于 refill: true 的服务，每个订单每 24 小时一次。多个订单请用逗号分隔发送 orders。

请求

curl -X POST https://clickpop.ir/api/reseller/v1 \
  -d key=YOUR_KEY \
  -d action=refill \
  -d order=10482

响应

{"refill": 50017}

补充状态

action=refill_status

请求

curl -X POST https://clickpop.ir/api/reseller/v1 \
  -d key=YOUR_KEY \
  -d action=refill_status \
  -d refill=50017

响应

{"status": "Completed"}

取消

action=cancel

仅适用于 cancel: true 的服务且须在开始交付前。未交付部分自动退款。

请求

curl -X POST https://clickpop.ir/api/reseller/v1 \
  -d key=YOUR_KEY \
  -d action=cancel \
  -d orders=10482,10483

响应

[
  {"order": 10482, "cancel": 1},
  {"order": 10483, "cancel": {"error": "Cancel is not available for this order"}}
]

余额

action=balance

请求

curl -X POST https://clickpop.ir/api/reseller/v1 \
  -d key=YOUR_KEY \
  -d action=balance

响应

{"balance": "2500000", "currency": "IRT"}

订单状态

状态	含义
`Pending`	已接收，等待开始
`In progress`	交付中；remains 表示剩余数量
`Completed`	已全部交付
`Partial`	部分交付；剩余金额已退回钱包
`Canceled`	未交付；全部金额已退回钱包

错误

错误以 {"error": "…"} 返回，文本固定，可在代码中判断。

错误	处理方法
`Invalid API key`	检查密钥，或在面板中新建一个
`IP not allowed`	将服务器 IP 加入密钥，或取消 IP 限制
`Not enough funds on balance`	请为钱包充值
`Incorrect service ID`	服务已下架或暂停，请重新获取服务列表
`Quantity out of range`	数量需介于 min 与 max 之间
`Incorrect link`	请发送对应平台的完整公开链接
`Incorrect order ID`	该账户下不存在此订单
`Orders are paused, try again later`	短暂维护，请几分钟后重试
`Incorrect request`	缺少必填参数或 action 无效

HTTP 429 表示请求过多：请等待一分钟并降低频率。

示例代码

PHP

<?php
function api(array $params): array
{
    $ch = curl_init('https://clickpop.ir/api/reseller/v1');
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => http_build_query(['key' => 'YOUR_KEY'] + $params),
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT => 30,
    ]);
    $json = json_decode((string) curl_exec($ch), true);
    curl_close($ch);
    return is_array($json) ? $json : ['error' => 'No response'];
}

$order = api(['action' => 'add', 'service' => 1204, 'link' => 'https://instagram.com/yourpage', 'quantity' => 1000]);
print_r($order);

Python

import requests

def api(**params):
    r = requests.post("https://clickpop.ir/api/reseller/v1", data={"key": "YOUR_KEY", **params}, timeout=30)
    return r.json()

print(api(action="balance"))
print(api(action="add", service=1204, link="https://instagram.com/yourpage", quantity=1000))

Node.js

const api = async (params) => {
  const res = await fetch("https://clickpop.ir/api/reseller/v1", {
    method: "POST",
    body: new URLSearchParams({ key: "YOUR_KEY", ...params }),
  });
  return res.json();
};

console.log(await api({ action: "balance" }));
console.log(await api({ action: "status", orders: "10482,10483" }));

限制与安全

每个密钥每分钟最多 240 次请求。
可将每个密钥限制为您的服务器 IP。
密钥仅显示一次，并以哈希形式存储；可随时吊销并重新创建。
密钥只能保存在服务器上——切勿放进网站 JavaScript 或移动应用。

获取 API 密钥

所有账户免费使用，无月费、无最低消费。

打开 API 设置