接口对接文档

成功响应

JSON

{
  "code": 200,
  "id": 1,
  "end_time": "2026-04-10 12:00:00",
  "amount": "30天",
  "available": 2592000,
  "token": "a1b2c3d4...",
  "statecode": "f1e2d3c4...",
  "safe_code": "hello"
}

失败响应

失败时 code 为 201，msg 是可读的原因。

JSON

{ "code": 201, "msg": "卡密不存在" }

文本格式

后台把返回格式设为「文本」时，首行是状态描述，其余每行 键:值。

登录成功
卡密ID:1
到期时间:2026-04-10 12:00:00
卡密时长:30天
剩余时间:2592000
校验密钥:a1b2c3d4
登录状态码:f1e2d3c4

文本格式没有 code 字段，判断成功要靠首行文案，不够稳。 建议统一用 JSON。

支持的算法

RSA 的方向与常规相反

分段大小：1024 位密钥加密块 117 字节、解密块 128 字节；2048 位分别为 245 / 256。

请求值编码

加密后的数据还要编码再传输：无编码 / Base64 / HEX。 建议用 HEX —— Base64 里的 + 在 URL 中会被转成空格，导致解密失败。

注意：加密一旦开启，所有参数值（含 t、 s、safe_code）都要加密并编码，漏一个就整体失败。

计算步骤

1. 把所有参数（排除 s 自身）按发送顺序拼成 k1=v1&k2=v2&…
2. 末尾追加 &{APPKEY}
3. 取 MD5（32 位小写），结果就是 s

PHP

$params = ['kami' => $kami, 'imei' => $imei, 't' => (string) time()];
$pair = [];
foreach ($params as $k => $v) { $pair[] = $k . '=' . $v; }
$s = md5(implode('&', $pair) . '&' . $APPKEY);
$params['s'] = $s;

开了加密时顺序不能错

签名用的是加密编码后的值，而且 s 本身也要加密编码后再传输。 正确顺序是：

明文参数 → 逐个加密 → 按规定编码 → 用编码后的值算签名 → 签名也要加密编码 → 提交

双向签名

后台选「双向签名」时，响应还会带 token。 客户端可用 md5(ID + APPKEY + 签名原文 + 到期时间 + 当前日期分钟) 校验响应是否被篡改。

规则

开启后所有请求必须带 t，值为 10 位秒级 Unix 时间戳，与服务器时差不得超过 30 秒。开启「校验增强」后，还要求请求时间不得晚于服务器时间（防重放）。

常见失败原因

通用

卡密

设备与 IP

账号

心跳

PHP

<?php
$base   = 'https://www.skyayue.top';
$appId  = 0;
$code   = 'code_kami_login';
$appkey = '你的APPKEY';
$rc4Key = '你的RC4密钥';

function rc4(string $d, string $k): string {
    $s = range(0, 255); $j = 0; $kl = strlen($k);
    for ($i = 0; $i < 256; $i++) {
        $j = ($j + $s[$i] + ord($k[$i % $kl])) & 0xFF;
        [$s[$i], $s[$j]] = [$s[$j], $s[$i]];
    }
    $o = ''; $i = 0; $j = 0;
    for ($n = 0; $n < strlen($d); $n++) {
        $i = ($i + 1) & 0xFF; $j = ($j + $s[$i]) & 0xFF;
        [$s[$i], $s[$j]] = [$s[$j], $s[$i]];
        $o .= chr(ord($d[$n]) ^ $s[($s[$i] + $s[$j]) & 0xFF]);
    }
    return $o;
}

$params = ['kami' => '卡密值', 'imei' => '设备号', 't' => (string) time()];

// 逐值加密 + HEX 编码
$wire = [];
foreach ($params as $k => $v) {
    $wire[$k] = strtoupper(bin2hex(rc4($v, $rc4Key)));
}

// 签名用编码后的值，末尾追加 &APPKEY
$pair = [];
foreach ($wire as $k => $v) { $pair[] = $k . '=' . $v; }
$s = md5(implode('&', $pair) . '&' . $appkey);
$wire['s'] = strtoupper(bin2hex(rc4($s, $rc4Key)));

$ch = curl_init("$base/api/$appId/$code");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => http_build_query($wire),
    CURLOPT_RETURNTRANSFER => true,
]);
$resp = json_decode((string) curl_exec($ch), true);
if (($resp['code'] ?? 0) == 200) {
    echo '到期：' . $resp['end_time'] . PHP_EOL;
    $statecode = $resp['statecode'];  // 后续心跳用
} else {
    echo '失败：' . ($resp['msg'] ?? '未知');
}

Java / Android

Map<String,String> params = new LinkedHashMap<>();
params.put("kami", card);
params.put("imei", deviceId);
params.put("t", String.valueOf(System.currentTimeMillis() / 1000));

// 加密 + HEX
Map<String,String> wire = new LinkedHashMap<>();
for (Map.Entry<String,String> e : params.entrySet()) {
    wire.put(e.getKey(), bytesToHex(rc4(e.getValue().getBytes("UTF-8"), rc4Key)));
}

// 签名
StringBuilder sb = new StringBuilder();
for (Map.Entry<String,String> e : wire.entrySet()) {
    if (sb.length() > 0) sb.append('&');
    sb.append(e.getKey()).append('=').append(e.getValue());
}
sb.append('&').append(appkey);
String s = md5Hex(sb.toString());
wire.put("s", bytesToHex(rc4(s.getBytes("UTF-8"), rc4Key)));

HttpURLConnection conn = (HttpURLConnection) new URL(
        base + "/api/" + appId + "/" + code).openConnection();
conn.setRequestMethod("POST");
conn.setDoOutput(true);
conn.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
try (OutputStream os = conn.getOutputStream()) {
    os.write(buildQuery(wire).getBytes("UTF-8"));
}
JSONObject json = new JSONObject(readAll(conn.getInputStream()));
if (json.optInt("code") == 200) {
    String statecode = json.getString("statecode");
    // 起定时器每 60 秒调心跳
} else {
    Log.e("verify", json.optString("msg"));
}

Python

import hashlib, time, requests

APPKEY = '你的APPKEY'
RC4KEY = b'你的RC4密钥'
BASE, APPID, CODE = 'https://www.skyayue.top', 0, 'code_kami_login'

def rc4(data: bytes, key: bytes) -> bytes:
    S = list(range(256)); j = 0
    for i in range(256):
        j = (j + S[i] + key[i % len(key)]) & 0xFF
        S[i], S[j] = S[j], S[i]
    out, i, j = bytearray(), 0, 0
    for ch in data:
        i = (i + 1) & 0xFF
        j = (j + S[i]) & 0xFF
        S[i], S[j] = S[j], S[i]
        out.append(ch ^ S[(S[i] + S[j]) & 0xFF])
    return bytes(out)

params = {'kami': '卡密值', 'imei': '设备号', 't': str(int(time.time()))}
wire = {k: rc4(str(v).encode(), RC4KEY).hex().upper() for k, v in params.items()}

sign_src = '&'.join(f'{k}={v}' for k, v in wire.items()) + '&' + APPKEY
wire['s'] = rc4(hashlib.md5(sign_src.encode()).hexdigest().encode(), RC4KEY).hex().upper()

r = requests.post(f'{BASE}/api/{APPID}/{CODE}', data=wire, timeout=15).json()
if r.get('code') == 200:
    print('到期：', r['end_time'])
    statecode = r['statecode']
else:
    print('失败：', r.get('msg'))

Node.js

const crypto = require('crypto');
const axios = require('axios');

const APPKEY = '你的APPKEY';
const RC4KEY = Buffer.from('你的RC4密钥');
const BASE = 'https://www.skyayue.top';
const APPID = 0;
const CODE = 'code_kami_login';

function rc4(data, key) {
  const S = [...Array(256).keys()]; let j = 0;
  for (let i = 0; i < 256; i++) {
    j = (j + S[i] + key[i % key.length]) & 255;
    [S[i], S[j]] = [S[j], S[i]];
  }
  const out = Buffer.alloc(data.length);
  let i = 0; j = 0;
  for (let n = 0; n < data.length; n++) {
    i = (i + 1) & 255; j = (j + S[i]) & 255;
    [S[i], S[j]] = [S[j], S[i]];
    out[n] = data[n] ^ S[(S[i] + S[j]) & 255];
  }
  return out;
}

const params = { kami: '卡密值', imei: '设备号', t: String(Math.floor(Date.now() / 1000)) };
const wire = {};
for (const [k, v] of Object.entries(params)) {
  wire[k] = rc4(Buffer.from(String(v)), RC4KEY).toString('hex').toUpperCase();
}

const signSrc = Object.entries(wire).map(([k, v]) => `${k}=${v}`).join('&') + '&' + APPKEY;
const s = crypto.createHash('md5').update(signSrc).digest('hex');
wire.s = rc4(Buffer.from(s), RC4KEY).toString('hex').toUpperCase();

axios.post(`${BASE}/api/${APPID}/${CODE}`, new URLSearchParams(wire))
  .then(r => {
    if (r.data.code == 200) console.log('到期：', r.data.end_time);
    else console.log('失败：', r.data.msg);
  });

C#

using System.Security.Cryptography;
using System.Text;

var appkey = "你的APPKEY";
var rc4Key = Encoding.UTF8.GetBytes("你的RC4密钥");
var baseUrl = "https://www.skyayue.top";
var appId = 0;
var code = "code_kami_login";

static byte[] Rc4(byte[] data, byte[] key) {
    var s = new byte[256];
    for (int i = 0; i < 256; i++) s[i] = (byte)i;
    int j = 0;
    for (int i = 0; i < 256; i++) {
        j = (j + s[i] + key[i % key.Length]) & 0xFF;
        (s[i], s[j]) = (s[j], s[i]);
    }
    var o = new byte[data.Length];
    int a = 0, b = 0;
    for (int n = 0; n < data.Length; n++) {
        a = (a + 1) & 0xFF; b = (b + s[a]) & 0xFF;
        (s[a], s[b]) = (s[b], s[a]);
        o[n] = (byte)(data[n] ^ s[(s[a] + s[b]) & 0xFF]);
    }
    return o;
}

var p = new Dictionary<string,string> {
    ["kami"] = "卡密值",
    ["imei"] = "设备号",
    ["t"] = DateTimeOffset.UtcNow.ToUnixTimeSeconds().ToString()
};
var wire = new Dictionary<string,string>();
foreach (var kv in p)
    wire[kv.Key] = Convert.ToHexString(Rc4(Encoding.UTF8.GetBytes(kv.Value), rc4Key));

var src = string.Join("&", wire.Select(kv => $"{kv.Key}={kv.Value}")) + "&" + appkey;
var md5 = Convert.ToHexString(MD5.HashData(Encoding.UTF8.GetBytes(src))).ToLowerInvariant();
wire["s"] = Convert.ToHexString(Rc4(Encoding.UTF8.GetBytes(md5), rc4Key));

var http = new HttpClient();
var resp = await http.PostAsync($"{baseUrl}/api/{appId}/{code}",
                                 new FormUrlEncodedContent(wire));
Console.WriteLine(await resp.Content.ReadAsStringAsync());