MVNet Solutions API Overview

REST API JSON

Base URL: https://www.mvnetsolutions.de/api/v1

Diese RESTful API ermöglicht es Ihnen, Benutzer, Produkte und Bestellungen zu verwalten. Alle Responses sind im JSON-Format und die API unterstützt Standard HTTP-Statuscodes.

REST API

Standard HTTP-Methoden

Sicher

Token Authentication

Schnell

Optimierte Performance

Accounting

GET /customer/balance/{token} Alle Guthabeninformationen abrufen

Example Response (200 OK)

Response content type: ["application/json", "application/json; charset=utf-8"]

POST /users Neuen Benutzer erstellen

Request Body

{
  "name": "Max Mustermann",
  "email": "max@example.com",
  "password": "securepassword123"
}

Response (201 Created)

{
  "id": 3,
  "name": "Max Mustermann",
  "email": "max@example.com",
  "created_at": "2024-01-17T09:15:00Z"
}

GET /users/{id} Benutzer nach ID abrufen

URL Parameter: id (integer) - Die ID des Benutzers

Response (200 OK)

{
  "id": 1,
  "name": "John Doe",
  "email": "john@example.com",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z"
}

KVM vServer

GET /servers/kvm/list/{token} Alle KVM vServer abrufen

Example Response (200 OK)

Response content type: ["application/json", "application/json; charset=utf-8"]

POST /servers/kvm/{id}/stop/{token} Stoppt den KVM vServer

Example Response (200 OK)

Response content type: ["application/json", "application/json; charset=utf-8"]

POST /servers/kvm/{id}/start/{token} Startet den KVM vServer

Example Response (200 OK)

Response content type: ["application/json", "application/json; charset=utf-8"]

POST /servers/kvm/{id}/restart/{token} Startet den KVM vServer neu

Example Response (200 OK)

Response content type: ["application/json", "application/json; charset=utf-8"]

POST /servers/kvm/{id}/shutdown/{token} Fährt den KVM vServer herunter

Example Response (200 OK)

Response content type: ["application/json", "application/json; charset=utf-8"]

POST /servers/kvm/{id}/force_stop/{token} Stoppt den KVM vServer sofort

Example Response (200 OK)

Response content type: ["application/json", "application/json; charset=utf-8"]

GET /servers/kvm/{id}/metrics/{timeframe}/{token} Gibt die Metrics vom KVM vServer aus

Example Response (200 OK)

Response content type: ["application/json", "application/json; charset=utf-8"]

Verfügbare Timeframes: 'hour', 'day', 'week', 'month', 'year'

GET /servers/kvm/{id}/state/{token} Gibt den Status vom KVM vServer aus

Example Response (200 OK)

Response content type: ["application/json", "application/json; charset=utf-8"]

GET /servers/kvm/{id}/tasks/{token} Gibt die aktuellen Aufgaben vom KVM vServer aus

Example Response (200 OK)

Response content type: ["application/json", "application/json; charset=utf-8"]

Products

GET /products Alle Produkte abrufen

Response (200 OK)

[
  {
    "id": 1,
    "name": "Premium Laptop",
    "description": "High-performance laptop for professionals",
    "price": 1299.99,
    "stock": 25,
    "category": "Electronics"
  },
  {
    "id": 2,
    "name": "Wireless Headphones",
    "description": "Noise-cancelling bluetooth headphones",
    "price": 199.99,
    "stock": 50,
    "category": "Audio"
  }
]

POST /products Neues Produkt erstellen

Request Body

{
  "name": "Gaming Mouse",
  "description": "RGB gaming mouse with programmable buttons",
  "price": 79.99,
  "stock": 100,
  "category": "Gaming"
}

Response (201 Created)

{
  "id": 3,
  "name": "Gaming Mouse",
  "description": "RGB gaming mouse with programmable buttons",
  "price": 79.99,
  "stock": 100,
  "category": "Gaming",
  "created_at": "2024-01-17T11:30:00Z"
}

Orders

POST /orders Neue Bestellung erstellen

Request Body

{
  "user_id": 1,
  "items": [
    {
      "product_id": 1,
      "quantity": 1
    },
    {
      "product_id": 2,
      "quantity": 2
    }
  ]
}

Response (201 Created)

{
  "id": 1,
  "user_id": 1,
  "total_amount": 1699.97,
  "status": "pending",
  "items": [
    {
      "product_id": 1,
      "product_name": "Premium Laptop",
      "quantity": 1,
      "unit_price": 1299.99
    },
    {
      "product_id": 2,
      "product_name": "Wireless Headphones",
      "quantity": 2,
      "unit_price": 199.99
    }
  ],
  "created_at": "2024-01-17T15:45:00Z"
}

GET /orders/{id} Bestellstatus abrufen

Response (200 OK)

{
  "id": 1,
  "user_id": 1,
  "total_amount": 1699.97,
  "status": "shipped",
  "tracking_number": "TRK123456789",
  "created_at": "2024-01-17T15:45:00Z",
  "updated_at": "2024-01-18T10:20:00Z"
}

HTTP Status Codes

Erfolgreiche Responses

200OK - Anfrage erfolgreich
201Created - Ressource erstellt
204No Content - Erfolgreich gelöscht

Fehler-Responses

400Bad Request - Ungültige Anfrage
401Unauthorized - Nicht authentifiziert
402Not verified - Account nicht verifiziert
403Forbidden - Zugriff verweigert
404Not Found - Ressource nicht gefunden
429Too Many Requests - Zu viele Anfragen
500Server Error - Interner Serverfehler