Beispielaufruf & Erklärung

Mit dieser API kann ein Tool den Ingame-CMDR-Namen zusammen mit dem JARVIS-API-Key an EliteBGS senden und erhält als Antwort ein JSON mit:

  • Favorites Watch (Events aus deinen Favoriten-Systemen, gefiltert nach Watch-States)
  • Faction Updates (Updates deiner gewählten Fraktion seit dem letzten Tick inkl. Delta)

Was du angeben musst

  1. ingame_name (Query-Parameter)
    → Dein Ingame-CMDR-Name
  2. X-CMDR-KEY (HTTP-Header)
    → Dein persönlicher JARVIS-API-Key
    Nur wenn Name + Key zusammen passen, liefert die API Daten.

Beispiel: API-Aufruf (curl)

Angenommen dein CMDR heißt “Cmdr NovaFox” und dein Key ist “NOVAFOX-KEY-12345”:

curl -s "https://elitebgs.net/api/api_cmdr_watch.php?ingame_name=Cmdr%20NovaFox" -H "X-CMDR-KEY: NOVAFOX-KEY-12345"

Alternative (GET/POST mit URL-Parameter statt Header):

curl -s "https://elitebgs.net/api/api_cmdr_watch.php?ingame_name=Cmdr%20NovaFox&api_key=NOVAFOX-KEY-12345"

Wichtig:

  • Leerzeichen im Namen müssen URL-kodiert sein (%20).
  • Der Key wird empfohlen im Header X-CMDR-KEY gesendet

Beispiel: JSON-Antwort

{
  "ok": true,
  "ingame_name": "Cmdr NovaFox",
  "favorites_watch": {
    "has_favs": true,
    "systems": [
      {
        "system_name": "Achenar",
        "system_last_update": 1767600000,
        "system_last_update_ago": "2 h",
        "config": {
          "watch_states": "war,election,civilwar,civilunrest",
          "delta_mode": 0,
          "delta_threshold": 5
        },
        "factions": [
          {
            "faction": "NovaFox Security",
            "influence_pct": 24.17,
            "active": ["Election"],
            "last_update": 1767599800,
            "last_update_ago": "2 h",
            "conflict": {
              "type": "election",
              "opponent": "Imperial Bureau",
              "won": 1,
              "lost": 0
            }
          }
        ]
      }
    ]
  },
  "faction_updates": {
    "has_faction": true,
    "faction": "NovaFox Security",
    "last_tick": 1767522752,
    "systems": [
      {
        "system": "HIP 12345",
        "active": ["CivilUnrest"],
        "pending": ["Expansion"],
        "last_update": 1767601200,
        "last_update_ago": "1 h",
        "influence_pct": 33.53,
        "delta_pct": +0.42
      },
      {
        "system": "LHS 3447",
        "active": [],
        "pending": ["Expansion"],
        "last_update": 1767600300,
        "last_update_ago": "2 h",
        "influence_pct": 12.10,
        "delta_pct": -0.15
      }
    ]
  }
}

Kurz erklärt

  • favorites_watch.systems[] enthält nur Favoriten-Systeme, in denen deine Watch-States (z.B. War/Election/Civil War/Civil Unrest/usw) zutreffen.
  • faction_updates.systems[] listet nur Systeme auf, deren last_update nach dem letzten Tick liegt.
  • delta_pct ist die Veränderung der Influence (in Prozentpunkten) gegenüber dem passenden Vergleichswert aus der History.

Beispielaufruf & Erklärung (BGS PP API – letzte 3 Ticks, ohne Gesamt/Totals)

Mit dieser API kann ein Tool den Ingame-CMDR-Namen zusammen mit dem JARVIS-API-Key an EliteBGS senden und erhält als Antwort ein JSON mit:

  • Staffel-/Squadron-Aktivitäten der letzten 3 Ticks
  • Pro Tick eine Liste rows[], aggregiert pro System + Fraktion
  • Kein gesamt/totals – Summen kann das Tool bei Bedarf selbst aus rows[] berechnen

Wenn für den CMDR eine SquadronName existiert, liefert die API Staffel-Daten, ansonsten Personal-Daten (Fallback).

Was du angeben musst

ingame_name (Query-Parameter)

→ Dein Ingame-CMDR-Name

X-CMDR-KEY (HTTP-Header)

→ Dein persönlicher JARVIS-API-Key
Nur wenn Name + Key zusammen passen (cmdr_s31.ingame_name + cmdr_s31.ingame_name_api), liefert die API Daten.

Beispiel: API-Aufruf (curl)

Angenommen dein CMDR heißt “Cmdr NovaFox” und dein Key ist “NOVAFOX-KEY-12345”:

curl -s "https://elitebgs.net/api/api_ppd_last3_rows.php?ingame_name=Cmdr%20NovaFox" -H "X-CMDR-KEY: NOVAFOX-KEY-12345"

Alternative (GET/POST mit URL-Parameter statt Header):

curl -s "https://elitebgs.net/api/api_ppd_last3_rows.php?ingame_name=Cmdr%20NovaFox&api_key=NOVAFOX-KEY-12345"

Wichtig:

  • Leerzeichen im Namen müssen URL-kodiert sein (%20).
  • Der Key wird empfohlen im Header X-CMDR-KEY gesendet.

Beispiel: JSON-Antwort

{
  "ok": true,
  "ingame_name": "Cmdr NovaFox",
  "ppd_last3": {
    "squadron": "NOVAFOX SQUADRON",
    "mode": "staffel",
    "ticks": [
      {
        "ticktime": "2026-01-06 07:00:00",
        "tick_berlin": "06.01.2026 08:00",
        "rows": [
          {
            "system": "Achenar",
            "Faction": "NovaFox Security",
            "mp": 120,
            "trade": 500000,
            "czl": 1,
            "czm": 0,
            "czh": 0,
            "merits": 10,
            "bm": 2500000,
            "bnt": 300000,
            "cart": 0,
            "exo": 0,
            "fail": 0,
            "murder": 0,
            "cmdr_list": "Cmdr NovaFox, Cmdr Alpha",
            "sett_list": "Dawes Hub"
          }
        ]
      }
    ]
  }
}

Kurz erklärt

ppd_last3.squadron

  • Enthält den SquadronName aus cmdr_status (falls vorhanden).
  • Ist leer, wenn keine Staffel gefunden wurde (dann mode = "personal").

ppd_last3.mode

  • "staffel": Daten werden nach staffel = SquadronName gefiltert
  • "personal": Fallback, Daten werden nach cmdr = <ingame_name> gefiltert

ppd_last3.ticks[]

Enthält bis zu 3 Tick-Blöcke (neuester zuerst).

ticks[].rows[]

Enthält aggregierte Einträge pro System + Fraktion.
Die Felder sind bereits innerhalb der Gruppe aufsummiert:

  • mp = MissionPoints + MissionPointsSecondary
  • trade = TradeProfit + TradePurchase
  • bm = CombatBonds SUM (COMB SUM)
  • bnt = Bounties
  • cart = CartData
  • exo = ExoData
  • fail = MissionFailed
  • murder = Murdered
  • czl/czm/czh = gcz_l / gcz_m / gcz_h
  • merits = merits
  • cmdr_list = beteiligte CMDRs (kommagetrennt)
  • sett_list = betroffene Settlements (kommagetrennt)

Summen pro Tick (Gesamtwerte) kannst du im Tool leicht selbst berechnen, indem du über rows[] iterierst und die Zahlen addierst.