API 接入文档

https://ddd.dedos.top/oauth.php?action=login&apikey=您的APIKEY&redirect_uri=https%3A%2F%2Fwww.yoursite.com%2Fpp-callback.php&state=随机32位串

https://ddd.dedos.top/oauth.php?action=pay&apikey=您的APIKEY&redirect_uri=https%3A%2F%2Fwww.yoursite.com%2Fpp-callback.php&amount=100&out_trade_no=PAY20260904001&description=%E4%BC%9A%E5%91%98%E6%9C%88%E5%8D%A1&state=随机32位串

https://www.yoursite.com/pp-callback.php?ticket=64位十六进制一次性票据&state=您发起时传入的state

POST /api.php HTTP/1.1
Host: passport.example.com
Content-Type: application/json

{
    "apikey":  "您的APIKEY",
    "domain":  "www.yoursite.com",
    "action":  "oauth_ticket",
    "ticket":  "回调地址上 ticket 参数的完整值（64位十六进制）"
}

{
    "code": 0,
    "msg": "授权成功",
    "data": {
        "action": "login",
        "state": "您发起时传入的state原样回传",
        "first_exchange": true,
        "ticket_status": "granted",
        "user": {
            "user_id": 10001,
            "username": "zhangsan",
            "nickname": "张三",
            "email": "zhangsan@example.com",
            "points": 1250,
            "status": 1,
            "status_text": "正常",
            "online": true,
            "has_pay_password": true,
            "has_questions": true,
            "created_at": "2026-08-01 12:30:00"
        }
    }
}

{
    "code": 0,
    "msg": "支付成功",
    "data": {
        "action": "pay",
        "state": "您发起时传入的state原样回传",
        "first_exchange": true,
        "ticket_status": "paid",
        "code": 0,
        "user_id": 10001,
        "username": "zhangsan",
        "amount": 100,
        "balance": 1150,
        "trade_no": "T260904103015123456",
        "out_trade_no": "PAY20260904001",
        "paid_at": "2026-09-04 10:30:15",
        "duplicate_order": false
    }
}

{
    "code": 14,
    "msg": "用户取消了支付",
    "data": {
        "action": "pay",
        "state": "您发起时传入的state原样回传",
        "ticket_status": "cancelled"
    }
}

<?php
/* 服务端直连：给用户增加积分（无需用户参与，如签到奖励、充值到账） */
$r = pp_api('points_inc', array(
    'user_id'      => 10001,               // 或 'username' => 'zhangsan'，二选一
    'amount'       => 50,                  // 正整数
    'out_trade_no' => 'INC' . date('YmdHis') . mt_rand(100, 999), // 您的流水号，必须唯一
    'description'  => '每日签到奖励',
));
if ($r['code'] === 0) {
    echo '入账成功，用户当前余额：' . $r['data']['balance'];
}
/* code=10 表示 out_trade_no 重复（该流水已入账），可用于防重复提交 */

<?php
/* 服务端直连：查询用户积分 */
$r = pp_api('points', array('username' => 'zhangsan'));
if ($r['code'] === 0) {
    $d = $r['data'];
    // $d['points']     当前余额
    // $d['month_in'] / $d['month_out']   本月收入/支出
    // $d['year_in']  / $d['year_out']    本年度收入/支出
}
/* 注意：points / profile 要求该用户已通过跳转授权本站点（历史交易 或 oauth.php 授权）后才可查询；
   未授权返回 code=16，请引导用户登录主站点击「同意授权」。
   未授权批量遍历 user_id 还会触发查询频率限制（默认每分钟 60 次，返回 code=17）。 */

/* 服务端直连：查询用户资料（隐私最小化） */
$r = pp_api('profile', array('user_id' => 10001));
if ($r['code'] === 0) {
    $u = $r['data']['user'];      // user_id/username/nickname/points（仅必要公开资料）
    $p = $r['data']['profile'];   // real_name/nickname/gender
}
/* 出于隐私保护，手机号/Tel、QQ/微信/微博、邮箱、家庭住址、身份证号等敏感字段
   不再通过 API 返回；如需用户完整资料，须用户 OAuth 授权后在主站个人中心查看。 */

<?php
/* ========== 通行证跳转授权接入（最小可用示例） ========== */
session_start();

$PP = array(
    'api_url'   => 'https://passport.example.com/api.php',   // 通行证 API 地址
    'oauth_url' => 'https://passport.example.com/oauth.php', // 通行证跳转授权页
    'apikey'    => '您的APIKEY',                              // 开放平台获得
    'domain'    => 'www.yoursite.com',                        // 您站点的登记域名
    'callback'  => 'https://www.yoursite.com/pp-callback.php',// 回调地址（域名须与登记一致）
);

/* 服务端调用 API（加积分 / 查询 / 票据交换） */
function pp_api($action, $params = array()) {
    global $PP;
    $ch = curl_init($PP['api_url']);
    curl_setopt_array($ch, array(
        CURLOPT_POST           => true,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT        => 15,
        CURLOPT_HTTPHEADER     => array('Content-Type: application/json; charset=utf-8'),
        CURLOPT_POSTFIELDS     => json_encode(array_merge(array(
            'apikey' => $PP['apikey'],
            'domain' => $PP['domain'],
            'action' => $action,
        ), $params)),
    ));
    $res = curl_exec($ch);
    curl_close($ch);
    $j = json_decode($res, true);
    return is_array($j) ? $j : array('code' => -1, 'msg' => '接口无响应');
}

/* 发起跳转（登陆 / 注册 / 支付共用） */
function pp_redirect($action, $extra = array()) {
    global $PP;
    $state = bin2hex(random_bytes(16));        // 随机 state，回调时校验
    $_SESSION['pp_state'] = $state;
    $q = array_merge(array(
        'action'       => $action,             // login / register / pay
        'apikey'       => $PP['apikey'],
        'redirect_uri' => $PP['callback'],
        'state'        => $state,
    ), $extra);                                // pay 时传 amount / out_trade_no / description
    header('Location: ' . $PP['oauth_url'] . '?' . http_build_query($q));
    exit;
}

/* ========== 回调处理（pp-callback.php 的核心逻辑） ========== */
if (isset($_GET['ticket'])) {
    /* ① 校验 state，防跨站请求伪造 */
    if (!isset($_SESSION['pp_state']) || ($_GET['state'] ?? '') !== $_SESSION['pp_state']) {
        exit('state 校验失败，请重新发起');
    }
    unset($_SESSION['pp_state']);

    /* ② 用一次性 ticket 换取结果 */
    $r = pp_api('oauth_ticket', array('ticket' => $_GET['ticket']));

    if ($r['code'] === 0 && $r['data']['action'] === 'pay') {
        /* ③ 支付成功：按 out_trade_no 幂等发货（同一订单只处理一次） */
        $d = $r['data'];   // amount / balance / trade_no / out_trade_no / paid_at ...
        // mark_order_paid($d['out_trade_no']);   // 您的发货逻辑
    } elseif ($r['code'] === 0) {
        /* ④ 登陆/注册成功：写入您站点的会话 */
        $_SESSION['pp_user'] = $r['data']['user']; // user_id/username/nickname/email/points ...
    } elseif ($r['code'] === 14) {
        /* 用户在通行证取消了授权或支付 */
    }
}

/* ========== 业务页面里发起跳转 ========== */
// 用户点「用通行证登陆」按钮时：
// pp_redirect('login');
// 用户下单扣积分时：
// pp_redirect('pay', array('amount' => 100, 'out_trade_no' => $orderId, 'description' => '会员月卡'));