De EnciclopAtys
(No se muestran 6 ediciones intermedias del mismo usuario) | |||
Línea 1: | Línea 1: | ||
− | + | <noinclude>{{Trad | |
|DE = Ryzom API |DEs= | |DE = Ryzom API |DEs= | ||
|EN = Ryzom API |ENs= 0 | |EN = Ryzom API |ENs= 0 | ||
− | |ES = Ryzom API |ESs= | + | |ES = Ryzom API |ESs= 2 |
|FR = Ryzom API |FRs= | |FR = Ryzom API |FRs= | ||
|RU = Ryzom API |RUs= | |RU = Ryzom API |RUs= | ||
Línea 12: | Línea 12: | ||
Esta página es la versión [[Portal:Forge|Ryzom Forge]] del sitio <span class="plainlinks">[https://api.ryzom.com/ api.ryzom.com]</span>. | Esta página es la versión [[Portal:Forge|Ryzom Forge]] del sitio <span class="plainlinks">[https://api.ryzom.com/ api.ryzom.com]</span>. | ||
− | De acuerdo a [[:wikipedia:es:Interfaz de programación de aplicaciones|Wikipedia]], una API ( en inglés, ''application programming interface'') o interfaz de programación de aplicaciones, es una interfaz informática que define las interacciones entre varios ''software'' como una capa de abstracción. Define los tipos de llamadas o solicitudes que se pueden realizar, cómo hacerlas, los formatos de datos que se deben utilizar, las convenciones a seguir, etc. [...]A través | + | De acuerdo a [[:wikipedia:es:Interfaz de programación de aplicaciones|Wikipedia]], una API ( en inglés, ''application programming interface'') o interfaz de programación de aplicaciones, es una interfaz informática que define las interacciones entre varios ''software'' como una [[wikipedia:es:capa de abstracción|capa de abstracción]]. Define los tipos de llamadas o solicitudes que se pueden realizar, cómo hacerlas, los formatos de datos que se deben utilizar, las convenciones a seguir, etc. [...] A través el enmascaramiento de información, las API permiten la programación modular, lo que permite a los usuarios usar la interfaz independientemente de la implementación. |
− | En nuestro caso | + | En nuestro caso, [[Ryzom API]] es un sistema basado en URL para obtener de Ryzom ''in-game information'' como el tiempo de juego, el perfil de personajes, de gremios... |
El registro de cambios de API se puede encontrar en '''<span class="plainlinks">[https://app.ryzom.com/app_forum/index.php?page=topic/view/18541 forum]</span>'''. | El registro de cambios de API se puede encontrar en '''<span class="plainlinks">[https://app.ryzom.com/app_forum/index.php?page=topic/view/18541 forum]</span>'''. | ||
− | |||
− | |||
− | |||
− | |||
− | == | + | ==Fundamentos== |
− | + | === URL de base === | |
− | + | Todas las consultas están usando '''<code><nowiki>https://api.ryzom.com</nowiki></code>''' como radical del URL. | |
− | |||
− | == | + | === Claves API === |
− | + | *Las claves API son 41 caracteres alfanuméricos. Los personajes comienzan con 'c' y los gremio con 'g'. | |
+ | *Las claves API deben crearse usando "RyzomAPI app": <span class="plainlinks">https://app.ryzom.com/app_ryzomapi</span> | ||
+ | *Debes ser líder del gremio o alto oficial para administrar y ver la clave API del gremio. | ||
− | == | + | === API PHP === |
− | + | La biblioteca API [[:wikipedia:es:PHP|PHP]] se puede encontrar en el repositorio [https://bitbucket.org/nimetu/ryzomapi_lite/src/default/ ryzomapi_lite]. | |
− | == | + | === Bibliotecas de terceros === |
− | = | + | Las traducciones de paginas PHP e información sobre los recursos se pueden encontrar en el repositorio <span class="plainlinks">https://github.com/nimetu/ryzom_extra</span>. La rama <span class="plainlinks">[https://github.com/nimetu/ryzom_extra/tree/json-resources json-resources]</span> tiene datos en formato [[:wikipedia:es:JSON|JSON]]. |
− | ==[[Ryzom API/Time|Time]]== | + | |
+ | === ¿Interfaz de [[:wikipedia:es:Python|Python]]?=== | ||
+ | ==Funciones== | ||
+ | ===[[Ryzom API/Time|Tiempo ''(Time)'']]=== | ||
+ | Es la fecha en el uso informático es decir: día y hora. | ||
+ | <nowiki>{{/Time}}:</nowiki><br/> | ||
{{/Time}} | {{/Time}} | ||
− | ==[[Ryzom API/Character|Character]]== | + | ===[[Ryzom API/Character|Personaje ''(Character)'']]=== |
+ | <nowiki>{{/Character}}:</nowiki><br/> | ||
{{/Character}} | {{/Character}} | ||
− | ==[[Ryzom API/Guilds|Guilds]]== | + | ===[[Ryzom API/Guilds|Guilds]]=== |
{{/Guilds}} | {{/Guilds}} | ||
− | ==[[Ryzom API/Guild|Guild]]== | + | ===[[Ryzom API/Guild|Guild]]=== |
{{/Guild}} | {{/Guild}} | ||
− | == API error codes == | + | === API error codes === |
;404 invalid api key : | ;404 invalid api key : | ||
Línea 58: | Línea 61: | ||
---- | ---- | ||
− | =Tools= | + | ==Tools== |
− | == [[Ryzom API/Render|Render]] == | + | === [[Ryzom API/Render|Render]] === |
{{/Render}} | {{/Render}} | ||
− | == [[Ryzom API/Guild icon|Guild icon]] == | + | === [[Ryzom API/Guild icon|Guild icon]] === |
{{/Guild icon}} | {{/Guild icon}} | ||
− | == [[Ryzom API/Item icon|Item icon]] == | + | === [[Ryzom API/Item icon|Item icon]] === |
{{/Item icon}} | {{/Item icon}} | ||
---- | ---- | ||
− | =In Game= | + | ==In Game== |
− | == [[Ryzom API/AppZone|AppZone]] == | + | === [[Ryzom API/AppZone|AppZone]] === |
{{/AppZone}} | {{/AppZone}} | ||
− | == In-game browser == | + | === In-game browser === |
---- | ---- | ||
− | =WikipAtys= | + | ==WikipAtys== |
− | ==Wiki implemetation== | + | ===Wiki implemetation=== |
Pages in [[:Category:API templates|Category : "API templates]]" : | Pages in [[:Category:API templates|Category : "API templates]]" : | ||
{{#dpl: | {{#dpl: | ||
Línea 87: | Línea 90: | ||
: 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]]. | : 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 === | + | ==== Examples ==== |
*[[Crafting/Crafting Part Table]] | *[[Crafting/Crafting Part Table]] | ||
*[[Template:APIitemIcon]] (documentation examples) | *[[Template:APIitemIcon]] (documentation examples) | ||
− | =Links= | + | ==Links== |
*API Documentation (sources): | *API Documentation (sources): | ||
**➡ https://api.ryzom.com/ | **➡ https://api.ryzom.com/ | ||
Línea 104: | Línea 107: | ||
----{{Last version link|Ryzom API}}<noinclude> | ----{{Last version link|Ryzom API}}<noinclude> | ||
{{Portal|Forge}} | {{Portal|Forge}} | ||
− | [[ | + | |
+ | [[Category: Trash]][[Category:Encyclopatys]] | ||
</noinclude> | </noinclude> |
Revisión actual del 15:33 31 oct 2021
Contenido
Esta página es la versión Ryzom Forge del sitio api.ryzom.com.
De acuerdo a Wikipedia, una API ( en inglés, application programming interface) o interfaz de programación de aplicaciones, es una interfaz informática que define las interacciones entre varios software como una capa de abstracción. Define los tipos de llamadas o solicitudes que se pueden realizar, cómo hacerlas, los formatos de datos que se deben utilizar, las convenciones a seguir, etc. [...] A través el enmascaramiento de información, las API permiten la programación modular, lo que permite a los usuarios usar la interfaz independientemente de la implementación.
En nuestro caso, Ryzom API es un sistema basado en URL para obtener de Ryzom in-game information como el tiempo de juego, el perfil de personajes, de gremios... El registro de cambios de API se puede encontrar en forum.
Fundamentos
URL de base
Todas las consultas están usando https://api.ryzom.com
como radical del URL.
Claves API
- Las claves API son 41 caracteres alfanuméricos. Los personajes comienzan con 'c' y los gremio con 'g'.
- Las claves API deben crearse usando "RyzomAPI app": https://app.ryzom.com/app_ryzomapi
- Debes ser líder del gremio o alto oficial para administrar y ver la clave API del gremio.
API PHP
La biblioteca API PHP se puede encontrar en el repositorio ryzomapi_lite.
Bibliotecas de terceros
Las traducciones de paginas PHP e información sobre los recursos se pueden encontrar en el repositorio https://github.com/nimetu/ryzom_extra. La rama json-resources tiene datos en formato JSON.
¿Interfaz de Python?
Funciones
Tiempo (Time)
Es la fecha en el uso informático es decir: día y hora.
{{/Time}}:
Ryzom API/Time
Personaje (Character)
{{/Character}}:
Ryzom API/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" :
- ⚠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?