Quelltext der Seite Ryzom API

<noinclude>{{WIP|Dieser Artikel wird gerade bearbeitet. Bitte laß es den Autor beenden, bevor du es veränderst. Die letzte Bearbeitung war von Leda am 24.05.2022.}}{{Trad
|DE = Ryzom API |DEs= 4
|EN = Ryzom API |ENs= 0
|ES = Ryzom API |ESs= 2
|FR = Ryzom API |FRs= 
|RU = Ryzom API |RUs= 
|H  = 1
|palette= Info
}}{{Clear}}<div style = "float:right;"> <small>__TOC__</small></div></noinclude>
<br />
<br />
<br />

Diese Seite ist die [[Portal:Forge|Ryzom Forge]]-Version der <span class="plainlinks">[https://api.ryzom.com/ api.ryzom.com]</span>-Seite.

Laut [[:wikipedia:Anwendungsprogrammierschnittstelle|Wikipedia]] ist eine API oder "''Anwendungsprogrammierschnittstelle''" eine Computerschnittstelle, die Interaktionen zwischen mehreren Softwarevermittlern definiert. Sie definiert die Arten von Aufrufen oder Anfragen, die gemacht werden können, wie sie gemacht werden können, die Datenformate, die verwendet werden sollten, die zu befolgenden Konventionen, usw. [...]Durch das Verstecken von Informationen ermöglichen APIs eine modulare Programmierung, die es den Benutzern ermöglicht, die Schnittstelle unabhängig von der Implementierung zu nutzen. 

In unserem Fall ist [[Ryzom API]] ein URL-basiertes System, um einige Ryzom ''in-game Informationen'' wie Spielzeit, Charakter, Gildenprofil... zu erhalten.
Das API-Änderungsprotokoll kann gefunden werden unter '''<span class="plainlinks">[https://app.ryzom.com/app_forum/index.php?page=topic/view/18541 forum]</span>'''.

=Grundlagen=
== Basis-URL ==
Alle Anfragen verwenden '''<code><nowiki>https://api.ryzom.com</nowiki></code>''' als Basis-URL.

== API Schlüssel ==
*API-Schlüssel bestehen aus 41 alphanumerischen Zeichen. Charakterschlüssel beginnen mit 'c' und Gildenschlüssel mit 'g'.
*API-Schlüssel müssen mit "RyzomAPI app" erstellt werden:  <span class="plainlinks">[https://app.ryzom.com/app_ryzomapi https://app.ryzom.com/app_ryzomapi]</span>
*Sie müssen Gildenleiter oder hoher Offizier sein, um den Api-Schlüssel der Gilde zu verwalten und einzusehen.

== PHP API ==
Die [[:wikipedia:PHP|PHP]]-API-Bibliothek befindet sich im [https://gitlab.com/ryzom/web/ryzom-api-client ryzom API client]-Repository.

== Bibliotheken von Drittanbietern ==
([[:wikipedia:PHP|PHP]]) Übersetzungen der Blätter und Informationen über Ressourcen finden Sie in der <span class="plainlinks">[https://github.com/nimetu/ryzom_extra https://github.com/nimetu/ryzom_extra]</span> Repository. Der <span class="plainlinks">[https://github.com/nimetu/ryzom_extra/tree/json-resources json-resources]</span> Zweig hat Daten im Format [[:wikipedia:JSON|JSON]].

== Python-Interface ?==
= Funktionen =
== [[Ryzom API/Time|Zeit]] ==
{{/Time}}

==[[Ryzom API/Charakter|Charakter]]==
{{/Charakter}}

==[[Ryzom API/Gilden|Gilden]]==
{{/Gilden}}

== [[Ryzom API/Gilde|Gilde]] ==
{{/Gilde}}

== API-Fehlercodes ==
;404 ungültiger API-Schlüssel : 
:Kein solcher API-Schlüssel.
;403 key expired :
:API-Schlüssel ist gültig, aber abgelaufen
;503 Charakterdaten sind nicht initialisiert: 
;503 Gilden-Daten sind nicht initialisiert:
:Temporärer serverseitiger Fehler, der anzeigt, daß die Charakter-/Gildeninformationen derzeit nicht verfügbar sind.
:Daten werden verfügbar sein, nachdem sich der Charakter im Spiel eingeloggt hat 
----

=Tools=

== [[Ryzom API/Render|Render]] ==
{{/Render}}

== [[Ryzom API/Gilden-Symbol|Gilden-Symbol]] ==
{{/Gilden-Symbol}}

== [[Ryzom API/Gegenstands-Symbol|Gegenstands-Symbol]] ==
{{/Gegenstands-Symbol}}
----

= In Game =
== [[Ryzom API/AppZone|AppZone]] ==
{{/AppZone}}

== In-Game-Browser ==

----

=WikipAtys=
==Wiki implemetation==
Pages in [[:Category:API templates|Category : "API templates]]" :
{{#dpl:
category=API templates
}}

;<big><big>⚠</big></big>Warning:
: The code required to retrieve icons is raw html. You won't be able to format pictures as "easily" as when you use wiki code and the image is stored on [[:Atys:Main Page|Atys commons]].

=== Examples ===
*[[Handwerk/Handwerks-Teile-Tabelle]]
*[[Template:APIitemIcon]] (documentation examples)

=Links=
*API Documentation (sources):
**➡ https://api.ryzom.com/
** ⛔ http://dev.ryzom.com/projects/ryzom-api/wiki (registered developers, 🔑 password required) 
*Example page and php library sources : https://bitbucket.org/nimetu/ryzomapi_lite
*Live working example page (Ballistic Mystix) : http://ryapp.bmsite.net/
*API discussion in forum : http://app.ryzom.com/app_forum/index.php?page=topic/view/18541
*the App (Appzone) Api key to create and get a key:  https://app.ryzom.com/app_ryzomapi/index.php?
<noinclude><br />
<br />
{{clear}}
{{Reflist|subpages=1}}{{Portal|Forge}}
[[Category:Ryzom API]]  [[Category:Tutorials]] [[Category:Gilden]]
[[de:Ryzom API]] [[en:Ryzom API]] [[es:Ryzom API]] [[fr:Ryzom API]] [[ru:Ryzom API]]  <!-- for Interlanguage  menu-->{{last version link|Ryzom API}}</noinclude>