Industry GO API
Externe Nur-Lese-API

Spieldaten klar abrufen.

Der Linkgenerator erstellt aus deinem vollständigen Account-API-Key einen direkt nutzbaren Link für Preise, Minen, Fabriken, Lager, Landwirtschaft, Kraftwerke, Handel und Kredite. Preisabfragen kosten 0 Credits.

0 Credits

Preise

Grundpreis, KI-Preis und aktueller Spielerpreis. Der Spielerpreis ist immer der höhere Wert aus KI-Preis und höchster aktiver Spieler-Kaufanfrage; eigene Kaufanfragen werden nicht berücksichtigt. Ohne höheren Spielerpreis wird der KI-Preis verwendet. Excel enthält nur ein Tabellenblatt mit der Preistabelle. Es gelten 30 Requests pro Minute je API-Key; der Reverse-Proxy kann früher drosseln.

Geschützt

Eigene Accountdaten

Ein einzigartiger API-Key pro Account mit dem Scope account:read. Derselbe vollständige Key wird im fertigen Link für alle sieben Accountthemen verwendet. Es gelten 30 Requests pro Minute. Minen, Fabriken, Felder, Wassergebäude und Kraftwerke erhalten stabile externalRef-Kennungen; Exporte sind auf 100.000 Minen, 10.000 Fabriken, 50.000 aktive Aufträge, 256 Lagerpositionen, 10.000 Felder, 10.000 Wassergebäude, 10.000 Kraftwerke sowie 25 MiB JSON bzw. 64 MiB XLSX begrenzt.

Daten abrufen

Der fertige Link enthält deinen vollständigen API-Key im Klartext. Teile ihn nicht öffentlich. Ohne Eingabe zeigt der Generator nur einen nicht funktionierenden Beispiel-Key.

Kosten: 0 API-Credits

Excel: Link kopieren und unter Daten → Daten abrufen → Aus dem Web einfügen. Preise, Minen, Fabriken, Lager, Landwirtschaft, Kraftwerke, Handel und Kredite haben einzeln jeweils nur ein Tabellenblatt ohne Metadaten-Tab. Der Preisexport enthält direkt die Spalten basePrice, aiPrice und playerPrice. Ein kombinierter Account-Export enthält je ausgewähltem Thema ein Tabellenblatt. Für andere Programme kann derselbe generierte Link als normale Webadresse verwendet werden.

Minen · 1 Credit

Alle eigenen Minen mit Ressource, Stufe, Qualität, exakten Koordinaten im Klartext, Zustand, Optimierung und bestätigtem Bestand.

/v1/account/mines.json

Fabriken · 1 Credit

Alle eigenen Fabriken mit Stufe, Betriebsfaktor, Auftrag, Status, Mengen und Fertigstellungszeit.

/v1/account/factories.json

Lager · 1 Credit

Der bestätigte allgemeine Lagerbestand aller Waren mit der aktuellen Stufe des jeweiligen Warenlagers. Externe Abrufe lösen keine Produktion oder Sammlung aus.

/v1/account/inventory.json

Landwirtschaft · 1 Credit

Agriculture V2: Felder und Wassergebäude gemeinsam als flache Liste mit recordType=field oder recordType=waterBuilding, auch in Excel nur ein Tabellenblatt. Feldname, Produkt, gespeicherter Status, Zyklusdauer, erwarteter Basisertrag je Zyklus, Dünger-Schalter und gespeicherter Zustand; Wassergebäude mit Typ und Radius. Keine Feldqualität oder Saatgutrückgabe.

readyAt ist ein gespeicherter Zeitplan, keine Garantie für Erntebereitschaft. expectedOutputPerCycle ist kein bestätigter Bestand und enthält keine Dünger- oder sonstigen Boni. Der Dünger-Schalter bestätigt keine Versorgung. Abrufe berechnen weder abgelaufene Zyklen noch Lebensverlust oder Ernte neu.

/v1/account/agriculture.json
/v1/account/agriculture.xlsx

Kraftwerke · 1 Credit

Eine Zeile je eigenem Kraftwerk mit Typ, Stufe, gespeicherten Leben und operationalRatio. nominalPowerKw und nominalFuelPerHour beschreiben Nennleistung und Nennverbrauch laut Typ und Stufe, nicht die tatsächliche aktuelle Leistung. Brennstofflose Anlagen haben keinen Brennstofftyp und Nennverbrauch 0.

Keine vollständige Energiebilanz oder Laufzeitprognose. Landwirtschaft, Kraftwerke, Handel und Kredite enthalten keine Koordinaten, Account-, Authentifizierungs- oder Gerätedaten. Campus wird nicht unterstützt.

/v1/account/power.json
/v1/account/power.xlsx

Handel · 1 Credit

Nur eigene offene, nicht abgelaufene Kaufanfragen (recordType=buyRequest, status=OPEN, expiresAt > generatedAt), danach noch gespeicherte eigene Transaktionen (recordType=transaction, side=BUY/SELL) im zurückliegenden 30-Tage-Fenster. Keine Verkaufsangebote. Je Gruppe aufsteigend nach Erstellungszeit und stabiler interner Reihenfolge.

remainingQuantity ist die gespeicherte Restmenge einer Kaufanfrage; die ursprüngliche Menge ist nicht mehr verfügbar, daher ist quantity=null. Transaktionen enthalten die ausgeführte quantity, aber remainingQuantity, status, expiresAt und updatedAt sind dort null. unitPrice ist der gespeicherte Preis. total wird nicht neu berechnet: bei Anfragen der reservierte Resthandelswert ohne separat gespeicherte Steuer, nicht der ursprüngliche Gesamtwert; bei Transaktionen der Bruttohandelswert, nicht die Nettoauszahlung nach Pfändung oder ein steuerinkludierender Kontogeldfluss.

Das einzelne JSON enthält history: {from, to, days: 30, completeness: "not-guaranteed"}. from liegt exakt 30 × 24 Stunden vor generatedAt, to entspricht generatedAt; beide Grenzen sind inklusive. Das beschreibt nur Transaktionen, nicht aktuelle Anfragen. Aufbewahrung und Löschungen können Zeilen entfernen: keine Garantie einer vollständigen 30-Tage- oder lebenslangen Historie. Im kombinierten JSON mit Handel steht history: {trade: {from, to, days: 30, completeness: "not-guaranteed"}}; ohne Handel fehlt history.

Unabhängige Grenzen: 10.000 Kaufanfragen und 10.000 Transaktionen, zusammen höchstens 20.000 Zeilen. Ein Überschreiten ergibt 413; Daten werden nicht abgeschnitten. Mengen in Waren (item), unitPrice in IC/item, total in IC.

Geordnete JSON-Felder / Excel-SpaltenrecordType, externalRef, side, itemType, name, status, quantity, remainingQuantity, unitPrice, total, expiresAt, createdAt, updatedAt
/v1/account/trade.json
/v1/account/trade.xlsx

Kredite · 1 Credit

Eigene aufgenommene Kredite (recordType=borrowedLoan), eigene Finanzierungsbeiträge einschließlich erstatteter Beiträge (funding), danach eigene historische Einzelkreditvergaben (legacyLending). Letztere nur bei eigener Kreditgeberrolle, source=PLAYER, fundingMode=LEGACY_SINGLE und wenn überhaupt keine Finanzierungsbeiträge zum Kredit existieren. Je Gruppe aufsteigend nach Erstellungszeit und stabiler interner Reihenfolge. Alle gespeicherten Statuswerte sind enthalten, auch ausstehend, storniert und bezahlt. source und status stammen vom zugehörigen Kredit, nicht aus einem berechneten Beitragsstatus.

principal, interestAmount, totalRepayable, paidAmount und remainingAmount sind gespeicherte Beträge in IC. Bei funding ausschließlich eigene Beitragsbeträge, niemals die Gesamtschuld des anderen Kreditnehmers. Bei aufgenommenen Krediten die eigene Schuld, bei strenger Einzelkreditvergabe die allein finanzierten Kreditbeträge. Unbekannte Beträge sind null, keine erfundene Null. Dies sind Buchungswerte, keine bestätigten aktuell einziehbaren Salden: ausstehende Beiträge können reserviertes Geld sein, erstattete Beiträge behalten ihre Beträge; refundedAt und status beachten.

dueAt ist die gespeicherte Kreditfälligkeit, bei ausstehenden Anfragen möglicherweise vorläufig. Keine Ratenbeträge, nächste Rate oder daraus abgeleitete Verspätungszusage; abgelaufene Zeit setzt den Status nicht auf OVERDUE. fundedAt bezeichnet bei Beiträgen deren Erfassungszeit, nicht die Auszahlung oder Aktivierung des gesamten Kredits. paidAt und refundedAt sind gespeicherte Zeitpunkte oder null; bei Kreditzeilen ist refundedAt immer null. createdAt/updatedAt stammen jeweils vom Ursprungsdatensatz.

Jeweils höchstens 10.000 aufgenommene Kredite, 10.000 eigene Beiträge und 10.000 strenge Einzelkreditvergaben, zusammen 30.000 Zeilen; jede Gruppe wird separat begrenzt. Überschreitung: 413, nicht abgeschnitten.

Geordnete JSON-Felder / Excel-SpaltenrecordType, externalRef, loanExternalRef, source, status, principal, interestAmount, totalRepayable, paidAmount, remainingAmount, dueAt, fundedAt, paidAt, refundedAt, createdAt, updatedAt
/v1/account/loans.json
/v1/account/loans.xlsx

Handels- und Kreditformat

JSON und Excel verwenden dieselben flachen Zeilen mit identischer Spaltenreihenfolge. Excel: je Thema genau ein Blatt, Handel / Kredite auf Deutsch und Trade / Loans auf Englisch, ohne Metadaten-Tab. Creditkosten und Restcredits stehen zusätzlich in den Antwortheadern. Alle Dezimalmengen und Geldbeträge sind Zeichenketten mit exakt sechs Nachkommastellen; fehlende oder nicht anwendbare Werte explizit null. Zeitstempel sind UTC in ISO-8601. Die bestehenden Grenzen 25 MiB JSON / 64 MiB XLSX gelten zusätzlich.

externalRef ist stabil und undurchsichtig, getrennt nach Datensatzzweck; loanExternalRef verweist auf den Kredit und entspricht bei Kreditzeilen externalRef. Nur name im Handel ist ein übersetzter Warenname; Maschinenfelder und Kreditzeilen bleiben sprachneutral. Keine Teilnehmernamen oder -IDs, Koordinaten, Risiko-, Ereignis-, Authentifizierungs- oder Gerätedaten. Ein gemeinsamer Nur-Lese-Snapshot für alle gewählten Themen, ohne Abrechnung, Ablaufverarbeitung, Pfändung oder Auszahlung. Das OpenAPI-Schema beschreibt Typen, Nullwerte und Limits.

Abrechnung

Eine kombinierte Abfrage addiert nur die verschiedenen Überthemen. Format, Zeilen und Detailfelder ändern die Kosten nicht. Landwirtschaft zählt trotz zwei Zeilentypen als ein Thema. Ohne include bleibt /v1/account/export.json bzw. .xlsx bei mines,factories,inventory für 3 Credits. Neue Themen müssen explizit ausgewählt werden. Die bisherigen fünf: /v1/account/export.json?include=mines,factories,inventory,agriculture,power für 5 Credits (derselbe vollständige Key muss zusätzlich als key übergeben werden; auch als .xlsx verfügbar). Alle sieben: /v1/account/export.json?include=mines,factories,inventory,agriculture,power,trade,loans für 7 Credits (auch .xlsx; vollständigen key ergänzen). Handel und Kredite kosten unabhängig vom Zeilentyp je 1 Credit. include ignoriert Leerzeichen um Themen, Groß-/Kleinschreibung, leere Kommaeinträge und Duplikate; mindestens ein gültiges Thema ist nötig. Ungültige oder intern fehlgeschlagene Requests werden nicht berechnet. Bei der ersten API-Aktivierung gibt es einmalig 5 API-Credits; eine Rotation oder ein erneutes Erstellen des Keys gibt keine weiteren Credits. Weitere Pakete mit 500 API-Credits sind wiederholt im In-Game-Shop erhältlich.

Fehler

  • 400 ungültiger Filter, Thema, Sprache oder Request-ID
  • 401 Key fehlt oder ist ungültig
  • 402 zu wenige API-Credits
  • 403 Scope fehlt
  • 409 Request-ID wurde bereits verwendet
  • 413 Export überschreitet ein Größenlimit
  • 429 Rate-Limit erreicht
  • 500 interner Fehler; reservierte Credits werden automatisch erstattet

Sicherheit

  • API-Key nur einmal nach Aktivierung oder Rotation sichtbar.
  • Der generierte Link enthält den Key im Klartext und muss wie der Key selbst privat bleiben.
  • Serverseitig wird ausschließlich ein kryptografischer Hash gespeichert.
  • Accountdaten werden nicht gecacht.
  • Alle Account-Endpunkte sind read-only und führen keinen Sync, AutoCollect oder Settlement aus.
  • Key-Verwaltung und Creditstand: user.industrygo.de.