🚀 VPN System REST API

API Documentation for Android VPN Apps

Base URL: https://www.vpn.upnews365.xyz/api

GET /servers.php

Description: Get list of VPN servers assigned to your API key

Headers:

X-API-Key: YOUR_API_KEY
Authorization: Bearer YOUR_API_KEY (alternative)

Optional Parameters:

device_id (string): Unique device identifier

Response:

{
  "success": true,
  "data": {
    "servers": [
      {
        "id": 1,
        "server_name": "USA Server 1",
        "country": "United States",
        "flag_url": "https://...",
        "status": "active"
      }
    ],
    "total": 1
  }
}

POST /connect.php

Description: Get OpenVPN configuration for specific server

Headers:

X-API-Key: YOUR_API_KEY
Content-Type: application/json

Request Body:

{
  "server_id": 1,
  "device_id": "unique-device-id" (optional)
}

Response:

{
  "success": true,
  "data": {
    "server": {
      "id": 1,
      "server_name": "USA Server 1",
      "country": "United States",
      "flag_url": "https://...",
      "ovpn_config": "client\nremote ..."
    }
  }
}

Error Responses

{
  "success": false,
  "error": "Error message",
  "code": "ERROR_CODE"
}

Common Error Codes:

MISSING_API_KEY - API key not provided
INVALID_API_KEY - API key does not exist
API_DISABLED - API key is disabled
LIMIT_EXCEEDED - Daily usage limit exceeded
SERVER_NOT_ACCESSIBLE - Server not assigned to this API

Note: Get your API key from the Admin Panel