接入文档

接入流程

1. 在商户控制台创建应用，填写回调域名并勾选要启用的登录渠道，拿到 AppID 和 AppSecret。
2. 用户在你的网站点击「微信登录」等按钮时，你的服务端调用「获取登录地址」接口，把用户浏览器跳转到返回的 url。
3. 平台按用户所在环境选择登录方式：电脑浏览器扫码、微信内授权、手机浏览器拉起小程序。用户第一次登录你的应用时需要在确认页同意提供信息。
4. 登录完成后，平台把用户浏览器跳回你的 redirect_uri，并带上 code 和你传入的 state。
5. 你的服务端用 code 调用「获取用户信息」接口，拿到该用户在你应用下的 openid、昵称和头像。code 只能使用一次，60 秒内有效。

签名规则

1. 取出除 sign 以外的全部请求参数，去掉值为空的参数。
2. 按参数名的 ASCII 码从小到大排序。
3. 拼接成 key1=value1&key2=value2 形式的字符串，值使用原始内容，不做 URL 编码。
4. 用 AppSecret 作为密钥，对该字符串做 HMAC-SHA256，结果转为小写十六进制，即为 sign。
5. timestamp 为当前 Unix 时间戳（秒），与平台时间相差不能超过 300 秒；nonce 为 8 到 64 位字母或数字的随机串，同一个 nonce 不能重复使用。

$params = [
    'app_id'       => '你的 AppID',
    'type'         => 'wechat',
    'redirect_uri' => 'https://www.example.com/login/callback',
    'state'        => 'abc123',
    'timestamp'    => (string) time(),
    'nonce'        => bin2hex(random_bytes(8)),
];
ksort($params, SORT_STRING);
$pairs = [];
foreach ($params as $key => $value) {
    if ($value !== '') {
        $pairs[] = $key . '=' . $value;
    }
}
$params['sign'] = hash_hmac('sha256', implode('&', $pairs), '你的 AppSecret');

获取登录地址

POSThttps://login.siyun223.com/api/v1/login/url

由你的服务端调用，返回的 url 有效期 10 分钟，只能在一个浏览器中打开。

请求参数

返回 data 字段

返回示例

{
    "code": 0,
    "msg": "成功",
    "data": {
        "url": "https://login.siyun223.com/connect/Xa9…（示意）",
        "expires_in": 600
    }
}

获取用户信息

POSThttps://login.siyun223.com/api/v1/login/user

用户被跳回 redirect_uri 后，用地址里的 code 换取用户信息。

请求参数

返回 data 字段

返回示例

{
    "code": 0,
    "msg": "成功",
    "data": {
        "openid": "o8Qd…（示意）",
        "type": "wechat",
        "type_name": "微信",
        "method": "wechat_web",
        "method_name": "微信扫码登录",
        "nickname": "示意昵称",
        "avatar": "https://…（示意）"
    }
}

回调参数

登录结束后，平台把用户浏览器跳转到 redirect_uri，并在地址后追加以下参数：

取值说明

渠道取值（type）

登录方式取值（method）

错误码

接口返回格式：{"code": 0, "msg": "成功", "data": {...}}，code 不为 0 时 data 为 null。

PHP SDK

单文件，支持 PHP 7.4 及以上，需要 curl 扩展。

下载 SiyunLogin.php

require 'SiyunLogin.php';

$client = new SiyunLogin('你的 AppID', '你的 AppSecret');

// 用户点击「微信登录」：生成 state 存入会话，跳转到登录地址
$state = bin2hex(random_bytes(16));
$_SESSION['login_state'] = $state;
header('Location: ' . $client->loginUrl('wechat', 'https://www.example.com/login/callback', $state));

// 回调地址：先校验 state，再用 code 换用户
if (! hash_equals($_SESSION['login_state'] ?? '', $_GET['state'] ?? '')) {
    exit('state 校验失败');
}
if (isset($_GET['error'])) {
    exit('用户取消了登录');
}
$user = $client->user($_GET['code']);
// $user['openid']、$user['nickname']、$user['avatar']

注意事项

• 接口请求格式为 application/x-www-form-urlencoded 或 application/json，返回格式为 JSON，code 为 0 表示成功。
• AppSecret 只能保存在你的服务端，不要写进网页或 App 中；泄露后请立即在控制台重置。
• 同一用户通过微信的不同方式（扫码、微信内、小程序）登录，拿到的 openid 相同。
• 小程序登录拿不到微信头像昵称，如果该用户之前没有通过其他方式登录过，nickname 和 avatar 为空。
• 用户撤回对你的应用的授权后，下次登录需要重新确认，openid 不变。