🔌 API文档

星途物流开放API - 实时获取网站状态与统计数据

📋 API概述

本API提供星途物流车队网站的实时状态信息，包括用户统计、活动数据、队员信息等。 所有数据以JSON格式返回，支持跨域访问（CORS），方便接入第三方应用或网站。

✨ 功能特性

  • 实时网站状态监控
  • 用户注册与认证统计
  • 注册用户列表（最新20位）
  • 认证用户详细列表
  • 活动数据统计
  • 队员信息统计与详细列表
  • 友情链接列表
  • 最新活动列表
  • 支持跨域访问（CORS）
  • JSON格式响应
  • 实时数据更新

🌐 API端点

https://swl.slc.org.cn/api/site_status.php

请求方法

GET 使用GET方法请求API

响应格式

application/json; charset=utf-8

📦 响应结构

成功响应示例

{
  "error": false,
  "message": "API请求成功",
  "timestamp": 1729692000,
  "datetime": "2024-10-23 14:30:00",
  "response": {
    "site_info": {
      "name": "星途物流 | Starway Logistics",
      "slogan": "捷运全球，途通八方",
      "description": "专业的欧洲卡车模拟器VTC车队",
      "vtc_url": "https://truckersmp.com/vtc/83889",
      "status": "online",
      "version": "1.0.0",
      "last_update": "2024-10-23 14:30:00"
    },
    "online_status": {
      "website": true,
      "database": true,
      "api": true
    },
    "statistics": {
      "users": {
        "total": 150,
        "certified": 45,
        "registered_list": [
          {
            "id": 1,
            "username": "张三",
            "email": "zhangsan@example.com",
            "joined_at": "2024-10-20 15:30:00"
          }
        ],
        "certified_list": [
          {
            "id": 2,
            "username": "李四",
            "email": "lisi@example.com",
            "vtc_status": "星途物流 | Starway Logistics",
            "tmp_id": "12345678",
            "joined_at": "2024-10-18 10:00:00"
          }
        ]
      },
      "activities": {
        "total": 28,
        "upcoming": 5
      },
      "members": {
        "total": 50,
        "member_list": [
          {
            "id": 1,
            "name": "王队长",
            "position": "队长",
            "join_date": "2024-01-01",
            "tmp_id": "87654321",
            "avatar": "uploads/members/avatar1.jpg"
          }
        ]
      },
      "friend_links": {
        "total": 8,
        "links_list": [
          {
            "id": 1,
            "name": "TruckersMP",
            "url": "https://truckersmp.com/",
            "logo": "uploads/friend-links/logo1.png",
            "sort_order": 1
          }
        ]
      },
      "convoy_reports": {
        "total": 15,
        "reports_list": [
          {
            "id": 1,
            "title": "星途物流首次大型联运活动",
            "convoy_date": "2024-10-15",
            "route": "柏林 → 慕尼黑",
            "participants": 25,
            "distance": 584.5,
            "duration": "4小时30分钟",
            "content": "本次联运活动圆满成功，所有参与队员准时到达目的地。",
            "views": 158,
            "created_at": "2024-10-16 10:00:00"
          }
        ]
      },
      "convoy_info": {
        "total": 8,
        "upcoming": 3,
        "info_list": [
          {
            "id": 1,
            "title": "周五晚间联运活动",
            "convoy_type": "upcoming",
            "convoy_time": "2024-10-25 20:00:00",
            "meeting_point": "杜伊斯堡服务区",
            "destination": "鹿特丹港口",
            "requirements": "TMP ID必填，需安装ProMods",
            "content": "欢迎所有队员参加本周五的常规联运活动！",
            "contact_info": "QQ群：123456789",
            "max_participants": 30,
            "current_participants": 12,
            "is_featured": true,
            "views": 245,
            "created_at": "2024-10-20 15:30:00"
          }
        ]
      },
      "latest_activities": [
        {
          "id": 1,
          "title": "跨欧联运活动",
          "event_date": "2024-10-30 20:00:00",
          "created_at": "2024-10-20 10:00:00"
        }
      ]
    }
  }
}

📊 数据字段说明

字段名 类型 说明
error Boolean 请求是否发生错误（false=成功，true=失败）
message String 响应消息
timestamp Integer Unix时间戳
datetime String 格式化的日期时间
response.site_info Object 网站基本信息
response.online_status Object 各服务在线状态
response.statistics.users.total Integer 总注册用户数
response.statistics.users.certified Integer 已认证用户数
response.statistics.users.registered_list Array 注册用户列表（最新20位，包含ID、用户名、邮箱、注册时间）
response.statistics.users.certified_list Array 认证用户列表（所有认证用户，包含ID、用户名、邮箱、VTC状态、TMP ID、注册时间）
response.statistics.activities.total Integer 活动总数
response.statistics.activities.upcoming Integer 即将举行的活动数
response.statistics.members.total Integer 队员总数
response.statistics.members.member_list Array 队员详细列表（所有队员，包含ID、姓名、职位、加入日期、TMP ID、头像）
response.statistics.friend_links.total Integer 友情链接总数
response.statistics.friend_links.links_list Array 友情链接列表（所有启用的链接，包含ID、名称、URL、Logo、排序）
response.statistics.convoy_reports.total Integer 联运出勤报告总数
response.statistics.convoy_reports.reports_list Array 联运出勤报告列表（最新10条已发布的报告，包含标题、日期、路线、参与人数、里程、时长、内容等）
response.statistics.convoy_info.total Integer 联运信息总数
response.statistics.convoy_info.upcoming Integer 即将举行的联运活动数量
response.statistics.convoy_info.info_list Array 联运信息列表（最新20条已发布的信息，包含标题、类型、时间、集合地点、目的地、要求、联系方式等）
response.statistics.latest_activities Array 最新5条活动列表

💻 使用示例

JavaScript (Fetch API)

fetch('https://swl.slc.org.cn/api/site_status.php')
  .then(response => response.json())
  .then(data => {
    console.log('网站状态:', data.response.site_info.status);
    console.log('总用户数:', data.response.statistics.users.total);
    console.log('认证用户:', data.response.statistics.users.certified);
    
    // 显示认证用户列表
    data.response.statistics.users.certified_list.forEach(user => {
      console.log(`认证用户: ${user.username} - ${user.vtc_status}`);
    });
    
    // 显示队员列表
    data.response.statistics.members.member_list.forEach(member => {
      console.log(`队员: ${member.name} (${member.position})`);
    });
    
    // 显示友情链接
    data.response.statistics.friend_links.links_list.forEach(link => {
      console.log(`友情链接: ${link.name} - ${link.url}`);
    });

    // 显示联运出勤报告
    data.response.statistics.convoy_reports.reports_list.forEach(report => {
      console.log(`联运报告: ${report.title} - ${report.convoy_date}`);
    });

    // 显示联运信息
    data.response.statistics.convoy_info.info_list.forEach(info => {
      console.log(`联运活动: ${info.title} - ${info.convoy_time}`);
    });
  })
  .catch(error => console.error('Error:', error));

PHP (cURL)

$ch = curl_init('https://swl.slc.org.cn/api/site_status.php');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo '总用户数: ' . $data['response']['statistics']['users']['total'] . "\n";

// 显示认证用户列表
foreach ($data['response']['statistics']['users']['certified_list'] as $user) {
    echo "认证用户: {$user['username']} - {$user['vtc_status']}\n";
}

// 显示队员列表
foreach ($data['response']['statistics']['members']['member_list'] as $member) {
    echo "队员: {$member['name']} ({$member['position']})\n";
}

// 显示联运出勤报告
foreach ($data['response']['statistics']['convoy_reports']['reports_list'] as $report) {
    echo "联运报告: {$report['title']} - {$report['convoy_date']}\n";
}

// 显示联运信息
foreach ($data['response']['statistics']['convoy_info']['info_list'] as $info) {
    echo "联运活动: {$info['title']} - {$info['convoy_time']}\n";
}

Python (requests)

import requests

response = requests.get('https://swl.slc.org.cn/api/site_status.php')
data = response.json()

print(f"网站状态: {data['response']['site_info']['status']}")
print(f"总用户数: {data['response']['statistics']['users']['total']}")

# 显示认证用户列表
for user in data['response']['statistics']['users']['certified_list']:
    print(f"认证用户: {user['username']} - {user['vtc_status']}")

# 显示队员列表
for member in data['response']['statistics']['members']['member_list']:
    print(f"队员: {member['name']} ({member['position']})")

# 显示友情链接
for link in data['response']['statistics']['friend_links']['links_list']:
    print(f"友情链接: {link['name']} - {link['url']}")

# 显示联运出勤报告
for report in data['response']['statistics']['convoy_reports']['reports_list']:
    print(f"联运报告: {report['title']} - {report['convoy_date']}")

# 显示联运信息
for info in data['response']['statistics']['convoy_info']['info_list']:
    print(f"联运活动: {info['title']} - {info['convoy_time']}")

🧪 在线测试

点击下方按钮实时测试API并查看响应数据