Ars Regendi Simulation Forum
Offizielle API für Ars Regendi - Printable Version

+- Ars Regendi Simulation Forum (https://forum.ars-regendi.com)
+-- Forum: Deutschsprachig: Über Ars Regendi (/forumdisplay.php?fid=1463)
+--- Forum: Skripterecke (/forumdisplay.php?fid=1767)
+--- Thread: Offizielle API für Ars Regendi (/showthread.php?tid=30306)


Offizielle API für Ars Regendi - Benedikt Magnus - 04.12.2016 21:11

Ars-API

Die offizielle API für Ars Regendi ist eine HTTP/HTTPS-Schnittstelle zur effizienten Ermittlung von Staats- und Weltendaten.


Bedingungen

Zur Nutzung der Schnittstelle ist ein persönliches Token notwendig, das bei mir per PN angefragt werden kann.

Die Nutzungsbedingungen sind folgende:

- Der Nutzer muss mindestens Premiummitglied sein.
- Der Zugang ist auf einen einzigen Nutzer je Token beschränkt.
- Mit der API darf keine Datenaufbereitung vorgenommen werden, die Ars Regendi selbst anbietet.
- Sämtliche Vorgänge mit der API werden protokolliert.
- Wir behalten uns vor, die API jederzeit zu ändern oder einzustellen.
- Ebenso behalten wir uns vor, Personen von der Nutzung auszuschließen.

Die Nutzungsbedingungen können jederzeit angepasst werden. Bei Änderung werden die Nutzer informiert.


Dokumentation

Schnittstellenadresse: api.ars-regendi.com/token/typ/id

token: Persönlicher Zugangsschlüssel
typ: s, w, oder ws
id: ID des Staates oder der Welt

s: Gibt Staatsdaten zurück.
w: Gibt Weltdaten zurück.
ws: Gibt Weltdaten und Daten der beinhaltenden Staaten zurück.

Rückgabetyp: JSON

Bei Zugriff als "api.ars-regendi.com/token" kann per POST ein JSON (Bezeichner: json) übergeben werden, das als ids eine Liste mit gewünschten Staats-IDs und als dat eine Liste der gewünschten Staatswerte bereitstellt. (Experimentelle Funktion!)

Die Rückgabe-JSON ist für die Staatsdaten ein Array der Daten, bei den Weltdaten ein Array der Daten plus eine Liste der Staats-IDs als ids, sowie für beides (ws) ein Array mit den Weltdaten und als dat ein Array der Staats-IDs, welche wiederum als Array die Daten beinhaltet.

Staatswerte sind:

'sMUS' = Musterstaat (siehe unten)
'sTIT' = Titel
'sNAM' = Name
'sWAE' = Währung
'sWAP' = Wappen
'sHAU' = Hauptstadt
'sREL' = Religion
'sHYM' = Hymne
'sDES' = Beschreibung
'rBEL' = Beliebtheit
'rMAC' = Macht
'rWEL' = Weltruf
'rGES' = Gesundheit
'rEIN' = Einfluss
'pUSE' = Regentenname

'KAS' = Kapitalsteuern
'KASA' = Kapitalsteuereinnahmen
'EWS' = Erwerbssteuern
'EWSA' = Erwerbssteuereinnahmen
'VBS' = Verbrauchssteuern
'VBSA' = Verbrauchssteuereinnahmen
'ZOL' = Zölle
'ZOLA' = Zolleinnahmen
'STV' = Staatsanlagevermögen
'STE' = Anderes Staatseinkommen
'SEG' = Gesamtes Staatseinkommen
'SQV' = SQ-Verwaltung
'SQJ' = SQ-Justiz
'SQB' = SQ-Bildung
'SQF' = SQ-Familie
'SQU' = SQ-Umwelt
'SQG' = SQ-Gesundheit
'SQVT' = SQ-Verteidigung
'SQS' = SQ-Subventionen
'SQSO' = SQ-Sonstiges
'SQP' = SQ-Projekte
'SQZ' = SQ-Zahlungen
'LHK' = Lebenshaltungskosten
'SQGE' = Grundeinkommen
'PST' = SQ-Grundeinkommen
'SQW' = Wohlfahrt
'GJW' = SQ-Wohlfahrt
'SQR' = Renten
'GJI' = SQ-Renten
'STA' = Staatsausgaben
'GEM' = Geldmenge
'STS' = Staatsschulden
'NOZ' = Nominalzins
'ZIZ' = Zinszahlungen
'NVS' = Neuverschuldung
'FLA' = Fläche
'BED' = Bevölkerungsdichte
'HUT' = Hungertote
'BEV' = Bevölkerung
'KIN' = Kinder
'AUS' = Auszubildende
'ERW' = Erwerbsfähige
'REN' = Rentner
'IMA' = Immigrantenanteil
'ABL' = Arbeitslose
'GBP' = Geburtenrate
'STR' = Sterberate
'ZUW' = Zuwanderung
'ABW' = Abwanderung
'BIG' = Bildungsgrad
'FOS' = Forschungsstand
'AUT' = Automatisierung
'SPO' = Sport
'KUN' = Kunst
'UNT' = Unterhaltung
'TOU' = Tourismus
'REL' = Religion
'BUR' = Bürgerrechte
'TIR' = Tierrechte
'CHG' = Chancengleichheit
'GIN' = GINI-Koeffizient
'DIS' = Diskriminierung
'DIR' = Dirigismus
'BRK' = Bürokratie
'GES' = Gesundheit
'UMW' = Umwelt
'IFS' = Infrastruktur
'LEE' = Lebenserwartung
'STB' = Steuerbelastung
'FRZ' = Freie Zeit
'GIX' = Glücklichkeitsindex
'VER' = Vergehen
'KAV' = Kapitalverbrechen
'SCW' = Schattenwirtschaft
'KOR' = Korruption
'MIL' = Militär
'ATM' = Atommacht
'WEP' = Wehrpflicht
'IMP' = Importe
'EXP' = Exporte
'PKO' = Privatkonsum
'SKO' = Staatskonsum
'BIN' = Bruttoinvestitionen
'BIP' = Bruttoinlandsprodukt
'WIW' = Wirtschaftswachstum
'RBI' = Reales BIP
'DEK' = Devisenkurs
'ABZ' = Arbeitszeit
'GWM' = Gewerkschaftsmitglieder
'NEK' = Nettoeinkommen
'BOD' = Bodenpreis
'ROI' = Rohstoffindex
'INF' = Inflation
'AIX' = Aktienindex
'SPQ' = Sparquote
'KAP' = Kapital

'wNAM' = Weltenname
'wUMW' = Weltumwelt
'wHER' = Weltherrscher


Musterstaaten-IDs:
1 = Deutschland/Industriemacht
3 = USA/Supermacht
4 = Indien/Schwellenland
5 = DDR/Postkommunistisch
6 = Russland/Rohstoffmacht
7 = Türkei/Industrieland
8 = Iran/Fundamentalistisch
12 = Kolumbien/Entwicklungsland
13 = Großbritannien/Finanzmacht


RE: Offizielle API für Ars Regendi - sero - 04.12.2016 21:13

Nur drei Jahre Hehe


RE: Offizielle API für Ars Regendi - Benedikt Magnus - 04.12.2016 21:19

Papperlapapp, noch am selben Abend habe ich damit angefangen. Tongue

Und sowieso: Was lange währt, wird endlich gut!


RE: Offizielle API für Ars Regendi - optimus rex - 04.12.2016 22:20

Ich finde die Umsetzung durch Benedikt hat erst einmal Lob und Anerkennung verdient. So etwas ist nicht in 2 Minuten realisiert und Benedikt hat eine Menge um die Ohren. Herzlichen Dank dafür, Benedikt. Applaus


RE: Offizielle API für Ars Regendi - Malone - 04.12.2016 22:51

optimus rex Wrote:
Ich finde die Umsetzung durch Benedikt hat erst einmal Lob und Anerkennung verdient. So etwas ist nicht in 2 Minuten realisiert und Benedikt hat eine Menge um die Ohren. Herzlichen Dank dafür, Benedikt. Applaus


Dankö Eyes


RE: Offizielle API für Ars Regendi - sero - 05.12.2016 18:43

Des kriegt er ja schon auf Telegram von mir nun oft genug zu hören Hehe


RE: Offizielle API für Ars Regendi - wiloyee - 20.04.2017 20:01

Auch von mir ein Großes Lob. Applaus

Auch wenn die API für mich etwas zu spät kommt. Ich hab meine eigenen Linux Scripte.

Bei meinen Script lese ich auch die Zufriedenheitswerte aus. Leider Funktioniert das nicht immer so wie ich will.
Es wäre schön wenn ihr diese Werte auch noch anbieten könntet.

Gruß
Bernd


RE: Offizielle API für Ars Regendi - BuffaloBill - 09.08.2017 13:13

eh ja, da fehlt jetzt nur noch eine Set Funktion wo ich dir das JSON zurückschicken kann, und die Daten meines Staates dann entsprechend geändert werden Hamma26x27 *Duck und weg*


RE: Offizielle API für Ars Regendi - TheLastShah - 23.02.2018 12:27

Gibt es ein Tutorial dazu, wie man die API nutzt? Ich (und bestimmt ein paar andere auch) würden sich sehr über eine Anleitung "für Dummies" freuen.


RE: Offizielle API für Ars Regendi - BuffaloBill - 23.02.2018 17:18

Das kommt ein bisschen darauf an wie du es nutzen möchtest....

Nehmen wir mal an, ich möchte die Beliebtheit von Welendor wissen. Also Beleibtheit ist rBEL, die ID von Welendor ist 207161.

also gebe ich in einen Browser meiner wal in die Adresszeile folgendes ein:
https://api.ars-regendi.com/[MEIN TOKEN]/s/207161

Wenn du das tust (und anstelle vom [Mein Token] deinen Tocken einsetzt Wink )
wird dir dein Browser eine Datei *.json zum Download anbieten, welches du in einem Editor deiner Wahl (z.b Notepad wenn du nix besseres zu hand hast) öffnen kannst und siehe da - da steht der Gewünschte Wert drin.

Das ist jetzt aber ziemlich witzlos wenn ich es so derart simplifiziere. Wirklich interessant wird es erst, wenn du eine Programmiersprache kanns wie etea php, perl,c#, java oder sonst irgend eine. So gut wie jede auch nur halbwegs als modern zu bezeichnende Programmiersprache bietet heutzugtage eine Schnittstelle für JSON, du fängst diese Datei als in deinem Programm ab, und tus damit...... was auch immer Wink


RE: Offizielle API für Ars Regendi - TheLastShah - 23.02.2018 17:39

Ich verstehe.... Hmm
Danke, Bill! Smile

Dann schreibe ich hier nochmal meinen Wunsch aus einer PN rein:

Für zahlende Spieler (ohne Programmierkenntnisse ^^) soll es eine einfache Möglichkeit geben, Staats- und Weltdaten als .cvs zu exportieren. Wir alle vergleichen und analysieren gerne, doch bisher ist es sehr aufwendig, Daten manuell abzugreifen (sofern man das händisch macht. Von Himami habe ich eine riesige OO-Datei gesehen, die aber auch alles andere als vollautomatisiert war).


RE: Offizielle API für Ars Regendi - optimus rex - 23.02.2018 17:55

Eine interessante Idee, Shah. Daumenhoch


RE: Offizielle API für Ars Regendi - Benedikt Magnus - 23.02.2018 18:28

TheLastShah Wrote:
Ich verstehe.... Hmm
Danke, Bill! Smile

Dann schreibe ich hier nochmal meinen Wunsch aus einer PN rein:

Für zahlende Spieler (ohne Programmierkenntnisse ^^) soll es eine einfache Möglichkeit geben, Staats- und Weltdaten als .cvs zu exportieren. Wir alle vergleichen und analysieren gerne, doch bisher ist es sehr aufwendig, Daten manuell abzugreifen (sofern man das händisch macht. Von Himami habe ich eine riesige OO-Datei gesehen, die aber auch alles andere als vollautomatisiert war).


Sieh dir doch mal an, was JSON so ist. Danach wirst du nie wieder fragen, ob du das als CSV haben könntest.
Und wenn du es wirklich in Excel verwenden willst, lässt sich auch dort relativ einfach ein JSON per HTTP abrufen und verarbeiten.
Im Übrigen, wenn es wirklich sein muss, gib mal "JSON zu CSV" in der Suchmaschine deiner Wahl ein. Wink