导入 AKSRT 主题开发源码

inc/classes/class-aksrt-sms-provider.php

@@ -0,0 +1,49 @@
+<?php
+/**
+ * AKSRT SMS Provider Interface
+ *
+ * 统一短信供应商接口。所有 SMS adapter 必须实现此接口。
+ *
+ * @package AKSRT
+ */
+
+defined('ABSPATH') || exit;
+
+interface AKSRT_SMS_Provider {
+
+    /**
+     * 供应商唯一标识
+     */
+    public function get_key(): string;
+
+    /**
+     * 供应商显示名称
+     */
+    public function get_label(): string;
+
+    /**
+     * 校验配置完整性，返回缺失字段列表
+     *
+     * @param array $config SMS 配置
+     * @return array 缺失的字段名列表，空数组表示配置完整
+     */
+    public function validate_config(array $config): array;
+
+    /**
+     * 发送短信验证码
+     *
+     * @param string $phone  手机号
+     * @param string $code   验证码
+     * @param array  $config SMS 配置
+     * @return array{success: bool, message: string, transport?: string}
+     */
+    public function send_code(string $phone, string $code, array $config): array;
+
+    /**
+     * 获取供应商运行时状态
+     *
+     * @param array $config SMS 配置
+     * @return array{configured: bool, available: bool, verified: bool, transport: string, missing_fields: array}
+     */
+    public function get_status(array $config): array;
+}