Ars Regendi Simulation Forum

Full Version: Offizielle API für Ars Regendi
You're currently viewing a stripped down version of our content. View the full version with proper formatting.
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
Nur drei Jahre Hehe
Papperlapapp, noch am selben Abend habe ich damit angefangen. Tongue

Und sowieso: Was lange währt, wird endlich gut!
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

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

Des kriegt er ja schon auf Telegram von mir nun oft genug zu hören Hehe
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
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*
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.
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
Pages: 1 2
Reference URL's