平台与 API

专为自动化与扩展而打造的平台

管理后台能做的一切,REST API 同样能做到。当您需要改变核心的行为方式时,事件钩子让您无需修改其中一行代码即可介入。

REST API

全部业务运营,只需一个 API

管理后台与 API 共用同一套权限映射,因此员工能做的任何操作,令牌都能完成。客户则拥有各自限定范围的接口。

GET 261
POST 187
DELETE 112
PUT 93
PATCH 63
Bearer + API 密钥 IP 白名单 120 次请求/分钟 令牌脱敏日志
打开 API 参考文档
716端点
19资源
112端点
13资源
# Create a client straight from your own signup flow
curl -X POST https://yourdomain.com/api/v1/clients \
  -H "Authorization: Bearer $WISECP_TOKEN" \
  -d '{
    "first_name": "Ada",
    "last_name": "Lovelace",
    "email": "[email protected]",
    "country": "GB"
  }'

# 201 Created
{ "status": "success", "data": { "id": 4821, "state": "active" } }
// Create a client straight from your own signup flow
$api = new WisecpClient(getenv('WISECP_TOKEN'));

$client = $api->clients->create([
    'first_name' => 'Ada',
    'last_name'  => 'Lovelace',
    'email'      => '[email protected]',
    'country'    => 'GB',
]);

echo $client->id; // 4821
// Create a client straight from your own signup flow
const api = new WisecpClient(process.env.WISECP_TOKEN);

const client = await api.clients.create({
    firstName: 'Ada',
    lastName: 'Lovelace',
    email: '[email protected]',
    country: 'GB',
});

console.log(client.id); // 4821
# List the signed-in client's unpaid invoices
curl https://yourdomain.com/api/v1/client/invoices?status=unpaid \
  -H "Authorization: Bearer $CLIENT_TOKEN"

# 200 OK
{
  "status": "success",
  "data": [
    { "id": 90233, "total": "42.00", "due": "2026-08-01" }
  ]
}
// List the signed-in client's unpaid invoices
$api = new WisecpClient(getenv('CLIENT_TOKEN'));

$invoices = $api->client->invoices->all([
    'status' => 'unpaid',
]);

foreach ($invoices as $invoice) {
    echo $invoice->total;
}
// List the signed-in client's unpaid invoices
const api = new WisecpClient(process.env.CLIENT_TOKEN);

const invoices = await api.client.invoices.all({
    status: 'unpaid',
});

invoices.forEach(i => console.log(i.total));

事件钩子

改变核心行为,无需改动核心

每个请求都会沿着一条路径穿过平台。在每个阶段,钩子都可以捕获请求、重塑其数据、注入界面,或直接终止它,而这一切都通过您自己的代码完成。

302

动作

响应事件:发送、记录、同步或触发您自己的工作流。

344

界面注入

在管理后台和客户界面中添加字段、面板和按钮。

198

过滤器

在核心使用某个值之前对其进行重塑,从价格到数据载荷皆可。

131

拦截器

直接否决某项操作:阻止订单、账单、登录或暂停。

11

注册

注册您自己的产品类型、路由或定时任务。

模块

用模块连接一切

九种有文档说明的模块类型覆盖您要接入的各类系统,从控制面板到支付网关。每种类型都附带入门骨架,让您从可运行的代码起步。

服务器

网站托管与服务器控制面板,支持创建、暂停、SSO 和用量统计。

支付

四种模式的支付网关:merchant、订阅、第三方和令牌化。

域名注册商

通过包含四十多个函数的接口契约对接域名注册商。

产品

拥有独立开通生命周期的自定义产品类型。

插件

可附加到任意产品或服务的插件。

SMS

用于通知和验证码的 SMS 网关。

电子邮件

用于事务性邮件和批量发送的邮件服务商。

身份验证

社交登录和单点登录服务商。

邮件转工单

自动将收到的电子邮件转换为工单。

拖放上传 GitHub 上的入门模板 每个模块均支持“测试连接”

架构

精简核心,为速度而调校

v5 核心运行在轻量的自研框架之上,API 拥有独立的快速通道,让现代技术栈在高负载下依然迅速。

轻量核心

为高吞吐量打造的自研 MVC 核心(coremio)。

API 快速通道

API 请求通过精简内核绕过 MVC 层。

现代运行环境

运行于 PHP 8.2 及更高版本,均为当前受支持的版本。

OpenAPI 3.1

文档由代码生成,并在构建时检查是否存在偏差。

开始构建

构建所需的一切

API 参考、钩子目录和模块指南都在开发者文档中,并提供可供复刻的入门模板。