🔌 API接口文档

完整的API接口说明和使用示例,帮助您快速集成加密服务到您的应用中

📋 接口概览

所有API请求都需要包含有效的API密钥,可以通过 api_key 参数传递。

💡 基础URL: https://jiami.zhuidc.com/api.php
接口 方法 描述 认证
upload POST 上传文件到加密服务器 ✅ 需要
submit POST 提交加密参数 ✅ 需要
download GET/POST 下载加密后的文件 ✅ 需要
status GET/POST 获取文件状态 ✅ 需要
user_info GET/POST 获取用户信息 ✅ 需要
recharge POST 使用卡密充值 ✅ 需要
history GET/POST 获取上传历史 ✅ 需要
quota GET/POST 查询配额和使用统计 ✅ 需要

🔑 认证方式

所有API请求都需要在参数中包含 api_key

https://jiami.zhuidc.com/api.php?action=user_info&api_key=YOUR_API_KEY

或者通过POST请求体传递:

{ "action": "user_info", "api_key": "YOUR_API_KEY" }

📤 文件上传 (upload)

POST https://jiami.zhuidc.com/api.php?action=upload

请求参数

参数 类型 必需 描述
api_key string 用户API密钥
file file 要加密的文件(ZIP或PHP)
encryption_type string 加密类型:IC, SG, DECK, GOTO, ENPHP, NONAME
edition string 版本(IC加密需要)

响应示例

{ "success": true, "message": "文件上传成功", "data": { "space": "abc123def456", "file_name": "example.zip", "file_size": 1024000, "php_file_count": 5, "encryption_type": "IC", "next_action": "请调用submit接口提交加密参数" }, "timestamp": 1690000000 }

⚙️ 提交加密参数 (submit)

POST https://jiami.zhuidc.com/api.php?action=submit

请求参数

参数 类型 必需 描述
api_key string 用户API密钥
space string 上传返回的space标识
version string PHP版本(IC/SG需要)
comment string 文件注释
allowed string 允许的IP地址(IC需要)
ip string IP限制(SG需要)
domain string 域名限制(SG/GOTO需要)

响应示例

{ "success": true, "message": "文件加密处理成功", "data": { "space": "abc123def456", "record_id": 123, "file_name": "example.zip", "encryption_type": "IC", "php_file_count": 5, "quota_deducted": 5, "download_url": "https://jiami.zhuidc.com/download.php?space=abc123def456&api_key=YOUR_API_KEY" }, "timestamp": 1690000000 }

🔗 获取下载链接 (download_url)

GET https://jiami.zhuidc.com/api.php?action=download_url&api_key=API_KEY&space=SPACE

请求参数

参数 类型 必需 描述
api_key string 用户API密钥
space string 文件space标识

响应示例

{ "success": true, "message": "获取下载链接成功", "data": { "file_info": { "space": "abc123def456", "file_name": "encrypted_files.zip", "file_size": 2048000, "file_size_formatted": "2.00 MB", "encryption_type": "IC", "php_file_count": 5, "created_at": "2024-01-15 10:30:00", "download_count": 3, "expires_in": "24小时" }, "download_url": "https://jiami.zhuidc.com/download.php?space=abc123def456&api_key=API_KEY&t=1690000000&token=abc123def4567890", "direct_download_url": "https://jiami.zhuidc.com/download.php?space=abc123def456&api_key=API_KEY&direct=1", "expires_at": "2024-01-16 10:30:00" }, "timestamp": 1690000000 }

批量获取下载链接

POST https://jiami.zhuidc.com/api.php?action=batch_download_urls
{ "action": "batch_download_urls", "api_key": "YOUR_API_KEY", "spaces": ["space1", "space2", "space3"] }

📥 文件下载 (download)

GET https://jiami.zhuidc.com/api.php?action=download&api_key=API_KEY&space=SPACE

直接返回文件流,用于下载加密后的文件。

注意: 下载接口返回的是文件二进制流,不是JSON响应。

📊 使用示例

<?php // PHP示例代码 $apiKey = 'YOUR_API_KEY'; $apiUrl = 'https://jiami.zhuidc.com/api.php'; // 1. 上传文件 $postData = [ 'api_key' => $apiKey, 'encryption_type' => 'IC', 'edition' => 'IC12', 'file' => new CURLFile('/path/to/your/file.zip') ]; $ch = curl_init(); curl_setopt_array($ch, [ CURLOPT_URL => $apiUrl . '?action=upload', CURLOPT_POST => true, CURLOPT_POSTFIELDS => $postData, CURLOPT_RETURNTRANSFER => true, ]); $response = curl_exec($ch); $uploadResult = json_decode($response, true); if ($uploadResult['success']) { $space = $uploadResult['data']['space']; // 2. 提交加密参数 $submitData = [ 'api_key' => $apiKey, 'space' => $space, 'version' => '7.4', 'comment' => 'API测试文件', 'allowed' => '192.168.1.1' ]; $ch = curl_init(); curl_setopt_array($ch, [ CURLOPT_URL => $apiUrl . '?action=submit', CURLOPT_POST => true, CURLOPT_POSTFIELDS => $submitData, CURLOPT_RETURNTRANSFER => true, ]); $response = curl_exec($ch); $submitResult = json_decode($response, true); if ($submitResult['success']) { // 3. 下载文件 $downloadUrl = $apiUrl . '?action=download&api_key=' . urlencode($apiKey) . '&space=' . urlencode($space); file_put_contents('encrypted_file.zip', file_get_contents($downloadUrl)); echo "文件加密下载完成!"; } } ?>
import requests api_key = 'YOUR_API_KEY' api_url = 'https://jiami.zhuidc.com/api.php' # 1. 上传文件 files = { 'file': open('/path/to/your/file.zip', 'rb') } data = { 'api_key': api_key, 'encryption_type': 'IC', 'edition': 'IC12' } response = requests.post(api_url + '?action=upload', files=files, data=data) upload_result = response.json() if upload_result['success']: space = upload_result['data']['space'] # 2. 提交加密参数 submit_data = { 'api_key': api_key, 'space': space, 'version': '7.4', 'comment': 'API测试文件', 'allowed': '192.168.1.1' } response = requests.post(api_url + '?action=submit', data=submit_data) submit_result = response.json() if submit_result['success']: # 3. 下载文件 download_url = api_url + '?action=download&api_key=' + api_key + '&space=' + space response = requests.get(download_url) with open('encrypted_file.zip', 'wb') as f: f.write(response.content) print("文件加密下载完成!")
# 1. 上传文件 curl -X POST \ "https://jiami.zhuidc.com/api.php?action=upload" \ -F "api_key=YOUR_API_KEY" \ -F "encryption_type=IC" \ -F "edition=IC12" \ -F "file=@/path/to/your/file.zip" # 2. 提交加密参数 curl -X POST \ "https://jiami.zhuidc.com/api.php?action=submit" \ -d "api_key=YOUR_API_KEY" \ -d "space=SPACE_FROM_UPLOAD" \ -d "version=7.4" \ -d "comment=API测试文件" # 3. 下载文件 curl -X GET \ "https://jiami.zhuidc.com/api.php?action=download&api_key=YOUR_API_KEY&space=SPACE_FROM_UPLOAD" \ -o encrypted_file.zip

📊 配额查询 (quota)

GET https://jiami.zhuidc.com/api.php?action=quota&api_key=API_KEY

请求参数

参数 类型 必需 描述
api_key string 用户API密钥

响应示例

{ "success": true, "message": "获取配额信息成功", "data": { "user_info": { "username": "testuser", "email": "[email protected]", "registration_date": "2024-01-01 10:00:00", "last_login": "2024-01-15 14:30:00" }, "quota_summary": { "current_quota": 95, "total_quota_received": 100, "total_quota_used": 5, "quota_usage_rate": 5.0, "remaining_quota": 95, "total_recharge_count": 1 }, "usage_statistics": { "today": { "uploads": 1, "files": 5, "quota_used": 5 }, "this_month": { "uploads": 10, "files": 50, "quota_used": 50 }, "total": { "uploads": 50, "files": 250, "quota_used": 250, "downloads": 120 } }, "encryption_costs": { "IC": { "name": "IC", "icon": "🔒", "description": "IC加密(按PHP文件数量收费)", "is_paid": true, "quota_per_file": 5, "supports_zip": true, "max_file_size": 2 }, "SG": { "name": "SG", "icon": "🛡️", "description": "SG14加密(按PHP文件数量收费)", "is_paid": true, "quota_per_file": 6, "supports_zip": true, "max_file_size": 2 } } }, "timestamp": 1690000000 }

字段说明

字段 类型 说明
quota_summary.current_quota integer 当前剩余配额
quota_summary.total_quota_received integer 累计获得配额
quota_summary.total_quota_used integer 累计使用配额
quota_summary.quota_usage_rate float 配额使用率(%)
usage_statistics.today object 今日使用统计
usage_statistics.this_month object 本月使用统计
usage_statistics.total object 总使用统计

❌ 错误代码

HTTP状态码 错误信息 说明
400 参数错误 请求参数缺失或格式错误
401 认证失败 API密钥无效或用户被禁用
404 资源未找到 请求的文件或记录不存在
429 请求过于频繁 API调用频率超限
500 服务器错误 服务器内部错误