API Documentation

Introduction

Welcome to the Matija Cloud API documentation. Our API allows you to programmatically manage your VPS and game servers, retrieve server statistics, and perform various administrative tasks.

Authentication

To use the API, you need to authenticate your requests using an API key. You can obtain your API key from your Matija Cloud account dashboard.

Include your API key in the header of each request:

Authorization: Bearer YOUR_API_KEY

Endpoints

1. List Servers

GET /api/v1/servers

Retrieve a list of all your servers.

Example Response:

{
  "servers": [
    {
      "id": "vps-001",
      "name": "My VPS Server",
      "type": "vps",
      "status": "running"
    },
    {
      "id": "mc-001",
      "name": "Minecraft Server",
      "type": "game",
      "game": "minecraft",
      "status": "stopped"
    }
  ]
}

2. Start Server

POST /api/v1/servers/{server_id}/start

Start a specific server.

3. Stop Server

POST /api/v1/servers/{server_id}/stop

Stop a specific server.

4. Get Server Statistics

GET /api/v1/servers/{server_id}/stats

Retrieve statistics for a specific server.

Example Response:

{
  "id": "vps-001",
  "cpu_usage": 25.5,
  "ram_usage": 4096,
  "disk_usage": 50000,
  "network_in": 1024,
  "network_out": 2048
}

Rate Limiting

The API is rate-limited to 100 requests per minute per API key. If you exceed this limit, you'll receive a 429 Too Many Requests response.

Support

If you have any questions or need assistance with the API, please contact our support team at api-support@matijacloud.com.