API 文档

概述

本系统提供微信公众号登录（验证码模式）的第三方授权服务。其他站点可通过 API 接入，实现用户使用微信登录功能。

接入步骤

1. 在后台“API管理”中添加应用，获取 AppID 和 AppKey。
2. 配置回调域名白名单（必须与站点域名一致）。
3. 引导用户访问授权接口，获取授权码。
4. 使用授权码和 AppKey 换取用户信息。

接口列表

接口名称	请求方式	说明
授权接口	GET	跳转至微信登录页面，获取授权码
获取令牌接口	POST	使用授权码换取用户信息（access_token）
获取用户信息接口	POST	使用 access_token 获取用户详细信息

1. 授权接口

URL： https://app.2bmzf.com/api/oauth.php

请求方式： GET

参数：

• appid - 必填，应用ID
• redirect_uri - 必填，回调地址，需要 urlencode，且必须在白名单内
• state - 可选，用于防止 CSRF，建议传递随机字符串

示例：

https://app.2bmzf.com/api/oauth.php?appid=YOUR_APPID&redirect_uri=https%3A%2F%2Fexample.com%2Fcallback&state=123456

说明： 用户授权成功后，会跳转回 redirect_uri 并携带参数 code 和 state。

2. 获取令牌接口

URL： https://app.2bmzf.com/api/token.php

请求方式： POST

参数：

• appid - 必填，应用ID
• appkey - 必填，应用密钥
• code - 必填，授权码

返回示例：

{
    "code": 0,
    "msg": "success",
    "data": {
        "access_token": "xxxxxx",
        "expires_in": 7200
    }
}

3. 获取用户信息接口

URL： https://app.2bmzf.com/api/userinfo.php

请求方式： POST

参数：

• appid - 必填，应用ID
• appkey - 必填，应用密钥
• access_token - 必填，从令牌接口获取的 access_token

返回示例：

{
    "code": 0,
    "msg": "success",
    "data": {
        "openid": "oToeE6j_YK4PA0kiR41cyDriyEL4",
        "nickname": "微信用户",
        "avatar": "https://...",
        "gender": 1
    }
}

错误码说明

• 1001 - 缺少必要参数
• 1002 - 应用不存在或被禁用
• 1003 - 回调域名不在白名单
• 1004 - 授权码无效或已过期
• 1005 - access_token 无效或已过期
• 1006 - appkey 验证失败

4. 实名认证接口

说明： 该接口用于第三方应用调用支付宝实名认证服务，需使用您创建的应用的 AppID 和 AppKey 进行鉴权，。

接口列表：

• /api/verify/init.php - 初始化认证，返回认证链接
• /api/verify/query.php - 查询认证结果

4.1 初始化认证

URL： https://app.2bmzf.com/api/verify/init.php

请求方式： POST

参数：

参数名	类型	必填	说明
appid	string	是	应用ID
appkey	string	是	应用密钥
real_name	string	是	真实姓名
cert_no	string	是	身份证号码
callback_url	string	是	认证完成后回调地址（必须与白名单域名一致）

返回示例：

{
    "code": 0,
    "msg": "success",
    "data": {
        "record_id": 123,
        "auth_url": "https://openapi.alipay.com/gateway.do?method=...",
        "expire_in": 300
    }
}

错误码：

• 1001 - 缺少必要参数
• 1002 - 应用不存在或密钥错误
• 1003 - 回调域名不在白名单
• 1004 - 系统未配置支付宝认证
• 1005 - 认证费用未配置
• 1006 - 积分不足
• 1007 - 扣费失败
• 1008 - 认证初始化失败

4.2 查询认证结果

URL： https://app.2bmzf.com/api/verify/query.php

请求方式： POST

参数：

参数名	类型	必填	说明
appid	string	是	应用ID
appkey	string	是	应用密钥
record_id	int	是	初始化返回的记录ID

返回示例：

{
    "code": 0,
    "data": {
        "status": 1,
        "real_name": "张三",
        "cert_no": "11010119900307663X",
        "result_msg": "认证通过"
    }
}