Firmen¶

Alle Firmen-Endpunkte beziehen sich auf Firmen, die der Charakter besitzt. Eine reine Anstellung reicht nicht aus.

Eigene Firmen¶

Liste¶

GET /factory/list/

Scopes: factory, optional factory.details

Liefert alle Firmen des Charakters. Mit factory.details werden zusätzlich isOpen, address und type befüllt.

[
  {
    "id": "65f...",
    "name": "Firma",
    "hash": "firma_hash",
    "isOpen": true,
    "type": "shop",
    "address": "Power Street 12"
  }
]

Inventare¶

Lager¶

GET /factory/inventory/{firmenId}

Scopes: factory, factory.inventory

Liefert das normale Firmenlager. Maschinenlager und Theke sind nicht enthalten.

Premium-Zusatzinhalt

Das Feld icon enthält nur mit Premium-Zugriff eine URL. Andernfalls ist der Wert null.

{
  "totalWeight": 125.5,
  "items": [
    {
      "item": "Produkt",
      "amount": 10,
      "singleWeight": 1.5,
      "totalWeight": 15,
      "icon": "https://static.statev.de/items/item_hash.webp"
    }
  ]
}

Maschinenlager¶

GET /factory/machine/{firmenId}

Scopes: factory, factory.inventory

Verwendet dieselbe Response-Struktur wie das normale Lager, enthält aber die Items aller Maschinenlager.

Premium-Zusatzinhalt

Das Feld icon enthält nur mit Premium-Zugriff eine URL. Andernfalls ist der Wert null.

Theke¶

GET /factory/counter/{firmenId}

Scopes: factory, factory.counter

Die Theke wird bei Endverbraucherläden wie 24/7, Restaurants, Kleidungsläden und Tankstellen unterstützt.

Premium-Zusatzinhalt

Das Feld icon enthält nur mit Premium-Zugriff eine URL. Andernfalls ist der Wert null.

{
  "totalWeight": 42,
  "items": [
    {
      "item": "Produkt",
      "price": 25,
      "amount": 4,
      "singleWeight": 1,
      "totalWeight": 4,
      "icon": null
    }
  ]
}

Produktion¶

Verfügbare Produktionen¶

Premium-Endpunkt

Dieser Endpunkt ist nur mit Premium-Zugriff verfügbar.

GET /factory/productions/{firmenId}

Scopes: factory, factory.productions

[
  {
    "itemName": "Produkt",
    "icon": "https://static.statev.de/items/item_hash.webp",
    "neededItems": [
      {
        "name": "Rohstoff",
        "amount": 2
      }
    ]
  }
]

Bank¶

Bankkonten¶

Premium-Endpunkt

Dieser Endpunkt ist nur mit Premium-Zugriff verfügbar.

GET /factory/bankaccounts/{firmenId}

Scopes: factory, factory.bankaccount

[
  {
    "id": "65f...",
    "vban": "VB123456",
    "balance": 15250.75,
    "note": "Hauptkonto"
  }
]

Transaktionen¶

Premium-Endpunkt

Dieser Endpunkt ist nur mit Premium-Zugriff verfügbar.

GET /factory/transactions/{bankId}/{limit?}/{skip?}

Scopes: factory, factory.bankaccount

limit ist optional und auf 25 begrenzt. skip ist optional und darf maximal 200 betragen.

{
  "totalTransactions": 84,
  "transactions": [
    {
      "senderVban": "VB123456",
      "receiverVban": "VB654321",
      "reference": "Bestellung",
      "amount": 1250,
      "timestamp": "2026-06-05T12:00:00.000Z"
    }
  ]
}

Autohaus¶

Fahrzeuge¶

GET /factory/vehicles/{factoryId}

Scopes: factory, factory.vehicles

Liefert alle Fahrzeuge, deren carShop der angegebenen eigenen Firma entspricht. Hat das Autohaus keine Fahrzeuge, wird ein leeres Array zurückgegeben. distance enthält die gefahrene Strecke in ganzen Metern.

Premium-Zusatzinhalt

Das Feld image enthält nur mit Premium-Zugriff eine URL. Andernfalls ist der Wert null.

[
  {
    "name": "Truffade Adder",
    "image": "https://static.statev.de/vehicle/adder.webp",
    "numberPlate": "STATEV",
    "distance": 1234,
    "engine": "1408ps"
  }
]

Marktplatzangebote¶

Verkaufsangebote¶

GET /factory/marketoffers/sell/{factoryId}

Scopes: factory, market

Premium-Zusatzinhalt

Das Feld icon enthält nur mit Premium-Zugriff eine URL. Andernfalls ist der Wert null.

[
  {
    "item": "Produkt",
    "pricePerUnit": 100,
    "totalPrice": 500,
    "availableAmount": 5,
    "createdAt": "2026-06-05T12:00:00.000Z",
    "icon": null
  }
]

Ankaufangebote¶

GET /factory/marketoffers/buy/{factoryId}

Scopes: factory, market

Die Response entspricht den Verkaufsangeboten und enthält zusätzlich listPrice.

Premium-Zusatzinhalt

Das Feld icon enthält nur mit Premium-Zugriff eine URL. Andernfalls ist der Wert null.

Verkaufslog¶

GET /factory/buyLog/{factoryId}/{limit}/{skip}

Scopes: factory, factory.buylog

Der Verkaufslog ist derzeit insbesondere für Werkstätten vorgesehen. limit darf maximal 50 und skip maximal 1000 betragen.

[
  {
    "seller": "Max Mustermann",
    "buyer": "Erika Musterfrau",
    "price": 500,
    "discount": 0,
    "items": [
      {
        "name": "Produkt",
        "amount": 2
      }
    ],
    "createdAt": "2026-06-05T12:00:00.000Z"
  }
]