API

我的 API 密钥

尚未生成 API 密钥。

接口文档（兼容 PerfectPanel API v2）

用程序对接 AAAA，查服务、下单、查订单、查余额都能自动完成。格式和 PerfectPanel 的 API v2 一样，已有对接代码基本不用改。

快速开始

所有请求都用 POST 发到 https://smm.eshuanshuan.eu.cc/api/v2，参数用表单或 JSON 都可以。每次都要带 key（你的密钥）和 action（要执行的操作）。

密钥

在用户面板的「API」页生成。密钥只显示一次，请马上保存好。重新生成后旧密钥立刻失效，也不要把密钥发给别人。

action=services — 获取服务列表。返回字段有服务编号、名称、类型、分类、价格（每 1000 个，单位美元）、最小数量和最大数量。

参数: key, action

[{"service":1,"name":"...","type":"Default","category":"...","rate":"0.9000","min":"50","max":"10000","refill":false,"cancel":true}]

action=add — 下单，参数是 service、link、quantity，返回订单号 order。费用从余额里扣。

参数: key, action, service, link, quantity

{"order":23501}

action=status — 查订单状态。单个订单传 order，批量查询传 orders（用逗号分隔，最多 100 个）。返回费用、起始数、状态和剩余量。

参数: key, action, order | orders

{"charge":"0.27819","start_count":"0","status":"Pending","remains":"100","currency":"USD"}

{"1":{"charge":"0.27","status":"Completed","remains":"0","currency":"USD"},"10":{"error":"Incorrect order ID"}}

action=balance — 查询账户余额和币种。

参数: key, action

{"balance":"100.84","currency":"USD"}

action=cancel — 申请取消订单，参数是 orders。只有还没开始处理的订单可以取消。

参数: key, action, orders

[{"order":9,"cancel":1},{"order":2,"cancel":{"error":"Order cannot be canceled"}}]

订单状态

Pending 是等待处理，In progress 是处理中，Completed 是已完成，Canceled 是已取消。

错误

出错时返回 {"error":"错误说明"}，请先看错误说明再重试。

cURL

curl -X POST https://smm.eshuanshuan.eu.cc/api/v2 \
  -d key=YOUR_API_KEY -d action=add \
  -d service=1 -d link=https://example.com/post -d quantity=100

PHP

<?php
$ch = curl_init('https://smm.eshuanshuan.eu.cc/api/v2');
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
  'key' => 'YOUR_API_KEY', 'action' => 'balance',
]));
$res = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($res);

所有服务都由 AAAA 团队人工交付。遇到问题，请到「工单」页联系我们。