REST API
全部业务运营,只需一个 API
管理后台与 API 共用同一套权限映射,因此员工能做的任何操作,令牌都能完成。客户则拥有各自限定范围的接口。
GET
261
POST
187
DELETE
112
PUT
93
PATCH
63
Bearer + API 密钥
IP 白名单
120 次请求/分钟
令牌脱敏日志
打开 API 参考文档
# 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
文档由代码生成,并在构建时检查是否存在偏差。