Time

Version 14 (kervala, 10/09/2012 09:07 am)

1 9 vl
h1. Time
2 1 vl
3 10 vl
This Ryzom API gets the time in the game servers (shards).
4 9 vl
5 1 vl
h2. Base URL
6 1 vl
7 13 kervala
* http://api.ryzom.com/time.php
8 6 vl
9 9 vl
h2. URL Parameters
10 1 vl
11 1 vl
h3. @format@ (optional) 
12 1 vl
13 1 vl
Default @format@ is @raw@.
14 1 vl
15 13 kervala
* @raw@: Returns the tick. The server tick is a 32 bit integer that increases by one every 100 milliseconds ("example":http://api.ryzom.com/time.php?format=raw).
16 14 kervala
* @txt@: Returns a homine-readable string ("example":http://api.ryzom.com/time.php?format=txt).
17 14 kervala
* @xml@: Returns an xml file that contains all shard time information ("example":http://api.ryzom.com/time.php?format=xml).
18 9 vl
19 1 vl
h2. Cache Duration
20 1 vl
21 1 vl
The data is cached during *1 minute*.
22 1 vl
23 9 vl
h2. PHP Interface
24 1 vl
25 13 kervala
h3. @ryzom_time_tick()@
26 9 vl
27 13 kervala
Returns the tick of Atys shard.
28 9 vl
29 1 vl
h3. @ryzom_time_txt($rytime)@
30 9 vl
31 9 vl
@$rytime@ is the array returned by @ryzom_time_array@.
32 9 vl
Returns the time in homine-readable string.
33 9 vl
34 9 vl
h3. @ryzom_time_xml($rytime)@
35 9 vl
36 9 vl
@$rytime@ is the array returned by @ryzom_time_array@.
37 1 vl
Returns the time in an xml format.
38 9 vl
39 13 kervala
h3. @ryzom_time_array($tick)@
40 9 vl
41 9 vl
Creates and returns an array containing all information about the time.
42 9 vl
43 9 vl
h2. Real Examples
44 1 vl
45 1 vl
If you have a website that use this Ryzom API, tell it in the forum and we'll add it.
46 9 vl
47 12 vl
* Unversal Widget (for windows, netvibes, igoogle,...) http://eco.netvibes.com/widgets/305491/ryzom-time
48 13 kervala
* Atys Time converter (sources available) http://ryzom.kervala.net/time.php