Aus EnzyklopAtys
!!!! WIP !!!! Die letzte Bearbeitung war von Zorroargh am 24.06.2022.
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.
• 
• 
• 
Inhaltsverzeichnis
Diese Seite ist die Ryzom Forge-Version der api.ryzom.com-Seite.
Laut 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 forum.
Grundlagen
Basis-URL
Alle Anfragen verwenden https://api.ryzom.com 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: https://app.ryzom.com/app_ryzomapi
- Sie müssen Gildenleiter oder hoher Offizier sein, um den Api-Schlüssel der Gilde zu verwalten und einzusehen.
PHP API
Die PHP-API-Bibliothek befindet sich im ryzom API client-Repository.
Bibliotheken von Drittanbietern
(PHP) Übersetzungen der Blätter und Informationen über Ressourcen finden Sie in der https://github.com/nimetu/ryzom_extra Repository. Der json-resources Zweig hat Daten im Format JSON.
Python-Interface ?
Funktionen
Time
Character
Guilds
Guild
API error codes
- 404 invalid api key
- No such API key.
- 403 key expired
- API key is valid, but has expired
- 503 character data is not initialized
- 503 guild data is not initialized
- Temporary server side error indicating that character/guild info is currently not available.
- Data will be available after character has logged in to game
Tools
Render
Guild icon
Item icon
In Game
AppZone
In-game browser
WikipAtys
Wiki implemetation
Pages in Category : "API templates" :
Extension:DynamicPageList (DPL), version 3.1.1: Warnung: Kein passender Eintrag gefunden!
- ⚠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 commons.
Examples
- Crafting/Crafting Part Table
- 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?
- Ergänzungen zu dieser Seite:
"" has no sub pages.
