a93c994aa9
- new caches element <wpts> for additional waypoints - added time to logs <date> field - renamed pictures <attributes> field to <picattr> - added preview flag to <picattr> - fixed errors in v1.1 and 1.2 DTDs
378 lines
24 KiB
HTML
378 lines
24 KiB
HTML
<html>
|
|
<head>
|
|
<title>Dokumentation Opencaching XML-Interface Version 1.2</title>
|
|
<meta name="vs_showGrid" content="True">
|
|
</head>
|
|
<body style="font-family: arial, sans-serif, Tahoma, Verdana; font-size:12px">
|
|
<h1>Dokumentation Opencaching XML-Interface Version 1.2</h1>
|
|
<p>
|
|
Das XML-Interface dient zum automatisierten abfragen aller Caches, Logeinträge,
|
|
Benutzer und/oder Bilder. Dieses Interface ist nicht für Endbenutzer gedacht,
|
|
sondern primär für Anwendungs-Entwickler.
|
|
</p>
|
|
<p>
|
|
<span style="color:red">Die abgerufenen Daten sind urheberrechtlich geschützt und dürfen nur unter den Bedingungen der <a href="http://www.opencaching.de/articles.php?page=impressum#datalicense">Opencaching.de-Datenlizenz</a> weitergegeben und genutzt werden.</span>
|
|
</p>
|
|
|
|
<p>
|
|
<em>The XML interface allows automatic download of cache, logs, user and/or pictures data.
|
|
It is not made for end-users but for application developers.<br />
|
|
This documentation is currently available in German only. If you need english text,
|
|
please contact us at <a href="mailto:contact@opencaching.de">contact@opencaching.de</a>
|
|
and tell us about the application you are going to develop; then we may translate it.<br />
|
|
<span style="color:red">The downloaded data is copyrighted and must only be used under the terms of <a href="http://www.opencaching.de/articles.php?page=impressum&locale=EN#datalicense">Opencaching.de data license</a>.</span></em>
|
|
</p>
|
|
|
|
<h2>Änderungen in Version 1.2 (Februar 2013)</h2>
|
|
<ul>
|
|
<li>neues Attribut <em>ispublishdate</em> bei cache.datecreated</li>
|
|
<li>Ausgabe von Nano-Cachgrößen</li>
|
|
</ul>
|
|
<p>Seit dem 7. April 2013 gibt es folgende Ergänzung:</p>
|
|
<ul>
|
|
<li>Wenn beim Auruf der zusätzliche Parameter "&license=1" angegeben ist, wird bei Cachebeschreibungen, Logs und Bildern ein zusätzliches Feld <license>...</license> mitgeliefert, das einen Copyright-Disclaimer gemäß <a href="http://www.opencaching.de/articles.php?page=impressum#datalicense">Datenlizenz</a> enthält. Dieser ist bei der Darstellung der Daten mit anzuzeigen und bei Weitergabe mitzuliefern. Wenn der license-Parameter <em>nicht</em> angegeben ist, wird der Disclaimer automatisch an alle Cachebeschreibungen angehängt. <br />
|
|
Mit dem zusätzlichen Parameter "language" kann die Sprache des Disclaimers gewählt werden,
|
|
z. B. "&language=de" für Deutsch. Ist "language" nicht angegeben, wird der Text
|
|
nach Möglichkeit in der Sprache der Cachebeschreibung bzw. des Logeintrags erzeugt,
|
|
ansonsten in Englisch.<br />
|
|
</li>
|
|
</ul>
|
|
|
|
<h2>Änderungen in Version 1.3 (Mai 2013)</h2>
|
|
<ul>
|
|
<li>Zusätzliche Wegpunkte von Caches werden nun in einer <wpts>...</wpts>-Liste mitgeliefert.</li>
|
|
<li>Das <date>-Element von Logs enthält nun auch die Uhrzeit. 00:00:00 bedeutet, dass keine Uhrzeit geloggt wurde; alles andere bedeutet, dass mit Stunde und Minute geloggt wurde.</li>
|
|
<li>Element für Bildeigenschaften von <attributes> in <picattr> umbenannt, um Kollisionen mit dem Cache-Attribut-Element zu vermeiden.</li>
|
|
<li>Vorschaubild-Flag (<em>preview</em>) zu <picattr> hinzugefügt.</li>
|
|
</ul>
|
|
|
|
<p>Der XML-Doctype lautet in allen Versionen "oc11xml".</p>
|
|
<h2>Ausgabeformat</h2>
|
|
<p>
|
|
Die Ausgabe ist eine oder mehrere xml,zip,gz oder bz2-Dateien. Es stehen 2
|
|
Übertragungsmodi bereit: in Paketen zu je 500 Datensätzen oder in
|
|
einer Datei.
|
|
<P>Die folgenden XML-Abschnitte stehen zur Verfügung. Sie werden immer in dieser
|
|
Reihenfolge ausgegeben:
|
|
<ol>
|
|
<li>
|
|
user (Benutzerdaten)
|
|
<li>
|
|
caches (Caches)
|
|
<li>
|
|
cachedesc (Cachebeschreibungen)
|
|
<li>
|
|
cachelog (Logeinträge)
|
|
<li>
|
|
picture (Bilder)
|
|
<li>
|
|
removedobject (gelöschte Objekte)</li>
|
|
</ol>
|
|
<P></P>
|
|
<h3>Allgemeine XML-Elemente</h3>
|
|
<h4>lastmodified</h4>
|
|
<p>Datum an dem dieser Datensatz zuletzt geändert wurde. Es werden keine
|
|
Abhängigkeiten berücksichtigt. D.h. Wenn eine Cachebeschreibung geändert wird,
|
|
ändert sich nur deren lastmodified, nicht jedoch das des Caches. Datumsangaben
|
|
sind immer in der Form "yyyy-mm-dd hh:mm:ss" oder "yyyy-mm-dd"</p>
|
|
<h4>datecreated</h4>
|
|
<p>Datum an dem dieser Datensatz angelegt wurde.</p>
|
|
<h4>id</h4>
|
|
<p>Zu unterscheiden ist die id (identifier) und die uuid (universal unique
|
|
identifier). Die id (Zahl) ist ein nur auf der jeweiligen Webseite gültiger
|
|
identifier, während die uuid (alphanumerische Folge) auf jeder Seite die
|
|
Opencaching-Daten verwendet gültig sein sollte. Beispiel: bei dem Datenabgleich
|
|
von www.opencaching.de und devel.opencaching.de wird auf devel.opencaching.de
|
|
eine neue id für den Datensatz erzeugt und die uuid beibhalten.</p>
|
|
<h3>Attributliste</h3>
|
|
<p><attrlist><br />
|
|
<attr id="1" icon_large="http://www.opencaching.de/images/attributes/night.gif"<br />
|
|
icon_no="http://www.opencaching.de/images/attributes/night-no.gif"<br />
|
|
icon_undef="http://www.opencaching.de/images/attributes/night-undef.gif"><br />
|
|
<![CDATA[Nachtcache]]><br />
|
|
</attr><br />
|
|
<attr id="6" icon_large="http://www.opencaching.de/images/attributes/oconly.gif"<br />
|
|
icon_no="http://www.opencaching.de/images/attributes/oconly-no.gif"<br />
|
|
icon_undef="http://www.opencaching.de/images/attributes/oconly-undef.gif"><br />
|
|
<![CDATA[Nur bei Opencaching]]><br />
|
|
</attr><br />
|
|
<attr id="7" icon_large="http://www.opencaching.de/images/attributes/wwwlink.gif"<br />
|
|
icon_no="http://www.opencaching.de/images/attributes/wwwlink-no.gif"<br />
|
|
icon_undef="http://www.opencaching.de/images/attributes/wwwlink-undef.gif"><br />
|
|
<![CDATA[Nur Hyperlink]]><br />
|
|
</attr><br />
|
|
<attr id="8" icon_large="http://www.opencaching.de/images/attributes/letterbox.gif"<br />
|
|
icon_no="http://www.opencaching.de/images/attributes/letterbox-no.gif"<br />
|
|
icon_undef="http://www.opencaching.de/images/attributes/letterbox-undef.gif"><br />
|
|
<![CDATA[Letterbox (benötigt Stempel)]]><br />
|
|
</attr><br />
|
|
</attrlist><br />
|
|
</p>
|
|
<h3>user (Benutzerdaten)</h3>
|
|
<p><user><br>
|
|
<id id="12345">4CE405E5-C110-CE00-9E88-8907F2212C73</id><br>
|
|
<username><![CDATA[Joe Geocacher]]></username><br>
|
|
<pmr>0</pmr><br>
|
|
<datecreated>2005-12-24 11:22:34</datecreated><br>
|
|
<lastmodified>2005-12-29 15:38:01</lastmodified><br>
|
|
</user></p>
|
|
<h4>username</h4>
|
|
<p>Benutzername</p>
|
|
<h4>pmr</h4>
|
|
<p>1: Der Benutzer hat angegeben ein PMR-Funkgerät auf Kanal 2 mit auf Tour zu
|
|
nehmen.<br>
|
|
0: Keine Angabe</p>
|
|
<h3>cache (Caches)</h3>
|
|
<P><cache><BR>
|
|
<id id="270">D455C916-7737-8210-F7FF-C6872E561CEB</id><br>
|
|
<user id="113" uuid=
|
|
"CAA9E3C5-50DF-4E9E-191F-CECABA6A8A19"><![CDATA[TeamSchnitzeljagd]]></user><br>
|
|
<name><![CDATA[Pegeluhr]]></name><br>
|
|
<longitude>8.45058</longitude><br>
|
|
<latitude>49.46393</latitude><br>
|
|
<type id="2" short="Trad."><![CDATA[normaler
|
|
Cache]]></type><br>
|
|
<status id="2"><![CDATA[Momentan nicht
|
|
verfügbar]]></status><br>
|
|
<country id="DE"><![CDATA[Deutschland]]></country><br>
|
|
<size id="2"><![CDATA[mikro]]></size><br>
|
|
<desclanguages>DE</desclanguages><br>
|
|
<difficulty>4</difficulty><br>
|
|
<terrain>2</terrain><BR>
|
|
<rating waylength="1.5" needtime= "0.5"></rating><br>
|
|
<waypoints gccom= "" nccom="" oc="OCR2D2"></waypoints><br>
|
|
<datehidden>2005-08-01</datehidden><br>
|
|
<datecreated ispublishdate="0">2005-09-08 15:45:02</datecreated><br>
|
|
<lastmodified>2005-12-20 20:58:41</lastmodified><br>
|
|
<attributes><br>
|
|
<attribute id="6"><![CDATA[Nur bei Opencaching]]></attribute><br>
|
|
</attributes><br>
|
|
<wpts><br />
|
|
<wpt id="25" type="1" typename="Parking" longitude="8.01667" latitude="50.00000"><![CDATA[Parkplatz, von hier 1 km Fußweg]]></wpt><br />
|
|
<wpt id="26" type="2" typename="Stage or reference point" longitude="8.02333" latitude="50.01544"><![CDATA[Station 1]]></wpt><br />
|
|
</wpts><br />
|
|
</cache></p>
|
|
<p><em>lastmodified</em> ist das letzte Änderungsdatum des cache-Datensatzes, ohne Änderungen an Cachebeschreibungen oder Bildern. Für das Gesamt-Änderungsdatum des Listings müssen Letztere also mit "eingerechnet" werden. Ein Gesamt-Änderungsdatum des Listings kann bei Bedarf eingebaut werden.</p>
|
|
<p><em>datecreated</em> ist bei mit OC Version 1 und 2 angelegten Caches das Datum, an dem das Listing angelegt wurde, bei mit Version 3 angelegten Caches das Veröffentlichungsdatum. Ab Interface Version 1.2 zeigt das Attribut <em>ispublishdate="1"</em> an, dass es sich um das Veröffentlichungsdatum handelt.</p>
|
|
<p>Ab XML-Version 1.2 werden im <em>size</em>-Feld auch Nano-Größen zurückgeliefert. In älteren Interface-Versionen wird stattdessen "micro" ausgegeben.</p>
|
|
<p>Es fehlen noch Empfehlungen und zusätzliche Wegpunkte; wird bei Bedarf eingebaut.</p>
|
|
<h3>cachedesc (Cachebeschreibungen)</h3>
|
|
<p>
|
|
<cachedesc><br>
|
|
<id id="5697">9BA489ED-AC62-B26D-6EC8-4D52DF3CD008&</id><br>
|
|
<cacheid
|
|
id="4927">AB551E31-8633-0CD1-26AD-324355D4E920</cacheid><br>
|
|
<language id="EN"><![CDATA[Englisch]]></language><br>
|
|
<shortdesc><![CDATA[Drive-In-Cache especially for
|
|
motorcyclists]]></shortdesc><br>
|
|
<desc html="1"><![CDATA[This MoCache is intended to connect the
|
|
MoCache series to other<br>
|
|
motorcycle-friendly caches on The Alb. Furthermore this great road<br>
|
|
between Erpfingen and Undingen was really worth it... &lt;br /&gt;<br>
|
|
&lt;br /&gt;<br>
|
|
&lt;a
|
|
href=&quot;http://people.freenet.de/6x7/mocaches.html&quot;&gt;Other
|
|
MoCaches</a&gt;<br>
|
|
]]></desc><br>
|
|
<hint><![CDATA[guard rail pole]]></hint><br>
|
|
<lastmodified>2005-12-24 14:38:13</lastmodified><br>
|
|
</cachedesc>
|
|
</p>
|
|
<h3>cachelog (Logeinträge)</h3>
|
|
<p>
|
|
<cachelog><br>
|
|
<id id="13037">F0DAC335-0FA6-3479-45AF-03E2F6BC28B9</id><br>
|
|
<cacheid
|
|
id="3439">048A8BF3-AA75-0741-CF60-6FBAE239EE11</cacheid><br>
|
|
<user id="113"
|
|
uuid="CAA9E3C5-50DF-4E9E-191F-CECABA6A8A19"><![CDATA[Team
|
|
Schnitzeljagd]]></user><BR>
|
|
<logtype id="1" recommended="0"><![CDATA[Gefunden]]></type><br>
|
|
<date>2005-05-18 16:20:00</date><br>
|
|
<text><![CDATA[Gut gefunden.&lt;br /&gt;<br>
|
|
Gr&uuml;&szlig;e von&lt;br /&gt;<br>
|
|
Volker]]></text><br>
|
|
<datecreated>2005-12-24 06:24:07</datecreated><br>
|
|
<lastmodified>2005-12-24 06:24:07</lastmodified><br>
|
|
</cachelog>
|
|
</p>
|
|
<h3>picture (Bilder)</h3>
|
|
<p>
|
|
<picture><br>
|
|
<id id="4619">558990D1-4DE2-50AF-B53A-135E87704D70</id><br>
|
|
|
|
<url>http://www.opencaching.de/images/uploads/558990D1-4DE2-50AF-B53A-135E87704D70.jpg</url><br>
|
|
<title><![CDATA[Schlurfende Gestalten]]></title><br>
|
|
<desc html="0"></desc><br>
|
|
<object id="73240" type="1" typename=
|
|
"cachelog">4FE4B999-315D-43C1-11C2-2B81E68168CD</object><br>
|
|
<picattr spoiler="0" display="1" preview="0" /><br>
|
|
<datecreated>2005-12-24 01:01:38</datecreated><br>
|
|
<lastmodified>2005-12-24 01:01:38</lastmodified><br>
|
|
</picture>
|
|
</p>
|
|
<h3>removedobject (gelöschte Objekte)</h3>
|
|
<p>
|
|
<removedobject><br>
|
|
<id id="748" /><br>
|
|
<object id="2388" type="6"
|
|
typename="picture">3C5A2147-BC21-CC96-B240-E3BEA829D936</object><br>
|
|
<removeddate>2005-12-24 15:11:23</removeddate><br>
|
|
</removedobject>
|
|
</p>
|
|
<h2>Datenauswahl</h2>
|
|
<p>Die Auswahl erfolgt zum einen durch den Paramter modifiedsince, mit dem
|
|
inkrementelle Updates gesteuert werden, zum anderen über eine Gebietsauswahl.</p>
|
|
<h3>Zu übertragende Daten auswählen</h3>
|
|
<p>Folgende Parameter stehen zur Verfügung um die zu übertragenden Daten
|
|
auszuwählen.</p>
|
|
<p>Die Werte dürfen 1 oder 0 sein, Default ist 0.<br />
|
|
0=Datensätze nicht übertragen<br />
|
|
1=Datensätze übertragen</p>
|
|
<ul>
|
|
<li>user</li>
|
|
<li>cache</li>
|
|
<li>cachedesc</li>
|
|
<li>cachelog</li>
|
|
<li>picture</li>
|
|
<li>removedobject</li></ul>
|
|
<h3>modifiedsince</h3>
|
|
<p>Alle Datensätz übertragen, die nach diesem Datum angelegt oder modifiziert
|
|
wurden. Das Datumsformat ist yyyymmddhhnnss</p>
|
|
<h3>Gebietsauswahl</h3>
|
|
<p>Es muss keine Gebietsauswahl getroffen werden. Eine Kombination von Land,
|
|
Koordinaten oder cacheid ist nicht möglich.</p>
|
|
<h4>Nach Land</h4>
|
|
<p>Parameter country ... wird dieser Parameter angegeben, werden nur Datensätze
|
|
übertragen, die mit Caches in Zusammenhang stehen, die in diesem Land versteckt
|
|
wurden. User-Records werden nicht übertragen, removedobjects werden alle
|
|
übetragen.</p>
|
|
<p>Für Bilder muss dabei angegeben werden, ob nur Bilder übertragen werden die
|
|
von Caches stammen oder auch von Cachelogs:<br/>
|
|
Paramter: picturefromcachelog = 0/1, default 0</p>
|
|
<h4>Nach Koordinaten</h4>
|
|
<p>Parameter lat, lon, distance ... werden diese Parameter angegeben,
|
|
werden nur Datensätz übertragen, die mit Caches in Zusammenhang stehen, die in
|
|
diesem Gebiet versteckt wurden. User-Records werden nicht übertragen,
|
|
removedobjects werden alle übetragen.</p>
|
|
<h4>Nach cacheid</h4>
|
|
<p>Parameter cacheid ... wird dieser Parameter angegeben,
|
|
werden nur Datensätz übertragen, die mit Cache in Zusammenhang stehen.
|
|
User-Records werden nicht übertragen,
|
|
removedobjects werden alle übetragen.</p>
|
|
<p>Für Bilder muss dabei angegeben werden, ob nur Bilder übertragen werden die
|
|
von Caches stammen oder auch von Cachelogs:<br/>
|
|
Paramter: picturefromcachelog = 0/1, default 0</p>
|
|
<h4>Nach Wegpunkt</h4>
|
|
<p>Paramter wp ... wie cacheid, ausser dass statt der cacheid der Opencaching Wegpunkt verwendet wird.</p>
|
|
<h4>Nach uuid</h4>
|
|
<p>Paramter uuid ... wie cacheid, ausser dass statt der cacheid die UUID des Caches verwendet wird.</p>
|
|
<h3>Beispiele</h3>
|
|
<p>1. Alle Daten inkrementell abrufen<br/>
|
|
<a>http://www.opencaching.de/xml/ocxml13.php?modifiedsince=<date>&user=1&cache=1&cachedesc=1&cachelog=1&picture=1&removedobject=1</a></p>
|
|
<p>2. Alle Daten von Deutschland inkrementell abrufen<br/>
|
|
<A>http://www.opencaching.de/xml/ocxml13.php?modifiedsince=<date>&cache=1&cachedesc=1&cachelog=1&picture=1&removedobject=0&country=DE&picturefromcachelog=1</a></p>
|
|
<p>3. Alle Caches ohne Logs von Deutschland inkrementell abrufen<br/>
|
|
<a>http://www.opencaching.de/xml/ocxml13.php?modifiedsince=<date>&cache=1&cachedesc=1&picture=1&removedobject=0&country=DE</a></p>
|
|
<p>4. Alle Daten im Umkreis von 15 km abrufen<br/>
|
|
<a>http://www.opencaching.de/xml/ocxml13.php?modifiedsince=<date>&cache=1&cachedesc=1&cachelog=1&picture=1&removedobject=0&lat=48&lon=9&distance=15&picturefromcachelog=1</a></p>
|
|
<p>5. Alle Bilder abrufen<br/>
|
|
<a>http://www.opencaching.de/xml/ocxml13.php?modifiedsince=<date>&picture=1</a></p>
|
|
<p>6. Alle Bilder von Caches abrufen die in Deutschland versteckt sind<br/>
|
|
<a>http://www.opencaching.de/xml/ocxml2.php?modifiedsince=<date>&picture=1&country=DE</a></p>
|
|
<p>7. Alle Bilder von Caches und deren Logs abrufen die in Deutschland versteckt
|
|
sind<br/>
|
|
<a>http://www.opencaching.de/xml/ocxml13.php?modifiedsince=<date>&picture=1&country=DE</a>&picturefromcachelog=1</p>
|
|
<p>Mit ocxml11.php kann stattdessen die Interface-Version 1.1 verwendet werden.</p>
|
|
<p>Diese Anfragen werden mit einem kurzen XML-Stream beantwortet, der die
|
|
XML-Session-Id zurückgibt. Mit dieser Id können dann die Daten abgerufen
|
|
werden.</p>
|
|
<p><?xml version="1.0"?><br/>
|
|
<ocxmlsession><br/>
|
|
<sessionid>12345</sessionid><br/>
|
|
<records user="193" cache="211" cachedesc="235" cachelog="439"
|
|
picture="108" removeobject="19" /><br/>
|
|
</ocxmlsession></p>
|
|
<p>Die Anzahl der Datensätz muss nicht exakt mit den übertragenen
|
|
übereinstimmen - mehr Datensätze werden jedoch auf keinen Fall übertragen. Die
|
|
Summe der Datensätze ist in diesem Beispiel 1205 - es werden also 3 Aufrufe
|
|
benötigt (500, 500, 205 Datensätze).</p>
|
|
<p>Die Daten können dann mit folgender Anfrage abgerufen werden:<br/>
|
|
<a>http://www.opencaching.de/xml/ocxml13.php?sessionid=12345&file=1</a><br/>
|
|
<a>http://www.opencaching.de/xml/ocxml13.php?sessionid=12345&file=2</a><br/>
|
|
<a>http://www.opencaching.de/xml/ocxml13.php?sessionid=12345&file=3</a></p>
|
|
<p>Die Sessionid ist zwei Stunden lang gültig, wobei sich dieser Zeitraum mit jedem
|
|
einzelnen Dateiabruf verlängert – zwischen den Einzelabrufen dürfen also
|
|
maximal zwei Stunden vergehen. Dauert es länger, müsste eine neue sessionid
|
|
angefordert werden.</p>
|
|
<h3>Alle Ergebnisse mit einem Aufruf abfragen</h3>
|
|
<p>Um alle Ergebnisse in einer Datei abzurufen muss bei dem Aufruf der Paramter
|
|
session auf 0 gesetzt werden.</p>
|
|
<p>Beispeil:<br/>
|
|
<a>http://www.opencaching.de/xml/ocxml13.php?modifiedsince=<date>&user=1&cache=1&cachedesc=1&cachelog=1&picture=1&removedobject=1&session=0</a></p>
|
|
<h3>Dateikomprimierung einstellen</h3>
|
|
<p>Dei Dateikomprimierung kann mit dem Paramter zip eingestellt weren. Mögliche
|
|
Werte sind 0, zip, bzip2, gzip. Null bedeutet hier keine Kompression. Wird
|
|
keine Kompression angegeben, wird zip verwendet.</p>
|
|
<p>Beispeil:<br/>
|
|
<a>http://www.opencaching.de/xml/ocxml13.php?modifiedsince=<date>&user=1&cache=1&cachedesc=1&cachelog=1&picture=1&removedobject=1&session=0&zip=bzip2</a><br/>
|
|
<a>http://www.opencaching.de/xml/ocxml13.php?sessionid=12345&file=1&zip=gzip</a></p>
|
|
<h3>XML-Optionen</h3>
|
|
<p>Die folgenden XML-Optionen müssen bei jedem Aufruf übergeben
|
|
werden.</p>
|
|
<p>xmldecl ... 0 = keine Xml-Deklaration / (Default) 1=Xml-Deklaration<br>
|
|
doctype ... 0 = keine Xml-Document-Type-Definition /
|
|
(Default) 1=Xml-Document-Type-Definition<br/>
|
|
ocxmltag ... 0 = kein oc11xml-Tag zu Beginn / (Default) 1=oc11xml-Tag
|
|
zu Beginn<br/>
|
|
cdata ... 0=XML-Steuerzeichen in Texten maskieren (z.B. & =>
|
|
&amp;) / (Default) 1=Texte in CDATA-Abschnitte einfassen<br/>
|
|
charset ... (Default) iso-8859-1 / utf-8<br />
|
|
attrlist ... (Default) 0 = keine Attributliste übertragen / 1 = Attributliste übertragen</p>
|
|
<h4><a>Beispiele</a></h4>
|
|
<p>http://www.opencaching.de/xml/ocxml13.php?modifiedsince=20060320000000&user=1&cache=1&cachelog=1&cachedesc=1&picture=1&removedobject=1&session=1&charset=utf-8&cdata=1&xmldecl=0&ocxmltag=0&doctype=0<br/>
|
|
http://www.opencaching.de/xml/ocxml13.php?sessionid=4711&file=1&charset=utf-8&cdata=1&xmldecl=0&ocxmltag=0&doctype=0</p>
|
|
<h3>Sonstige Anmerkungen</h3>
|
|
<ul>
|
|
<li>
|
|
Für den ersten Aufruf des Interface muss als modifiedsince das Datum 1.8.2005
|
|
um 00:00:00 Uhr angegeben werden. Es gibt keine Datensätze die vor diesem Datum
|
|
angelegt wurden.<br /><br /></li>
|
|
<li>
|
|
Um Probleme wegen Differenzen der Uhrzeit zwischen Client und Server zu
|
|
umgehen, muss für den nächsten Inkrementellen Abruf der Daten das Datum um Kopf
|
|
der XML-Datei minus 1 Sekunde angeben werden:<br/>
|
|
<span class="m"><br/><?</span><span class="pi">xml version="1.0" encoding="iso-8859-1"
|
|
standalone="no" </span><span class="m">?></span>
|
|
<br/>
|
|
<span><span class="d"><!DOCTYPE oc11xml<I>...</I>></span> <br/></span>
|
|
<span class="m"><</span><span class="t">oc11xml</span><span class="t">
|
|
version</span><span class="m">="</span>1.2<span class="m">"</span><span class="t">
|
|
date</span><span class="m">="</span><strong>2006-03-10 18:37:34</strong><span class="m">"</span><span class="t"> since</span><span class="m">="</span>2006-03-08
|
|
22:02:42<span class="m">"</span><span class="m">></span><br /><br />
|
|
</li>
|
|
<li>Zeitverschiebungen / unterschiedliche Zeitzonen zwischen Client und Server
|
|
werden nicht unterstützt.</li>
|
|
</ul>
|
|
<h3>Ressourcen</h3>
|
|
<ul>
|
|
<li>Das XML-Dokument enthält folgende DTD (Document Type Definition):
|
|
http://www.opencaching.de/xml/ocxmlXX.dtd mit XX = Versionummer, z.B. ocxml12.dtd für Version 1.2.</li>
|
|
<li>Der Quellcode ist hier erhältlich: <a href="https://github.com/OpencachingDeutschland/oc-server3/tree/stable/htdocs/xml">
|
|
https://github.com/OpencachingDeutschland/oc-server3/tree/stable/htdocs/xml</a></li>
|
|
<li>Eine Referenzimplementierung kann hier heruntergeladen werden:
|
|
<a href="https://github.com/OpencachingDeutschland/oc-server3/tree/stable/htdocs/util-local/ocxml11client">https://github.com/OpencachingDeutschland/oc-server3/tree/stable/htdocs/util-local/ocxml11client</a></li>
|
|
<li>Fragen zum Interface können im Opencaching-Forum gestellt werden: <a href="http://forum.opencaching-network.org/">http://forum.opencaching-network.org/</a></a></li>
|
|
</ul>
|
|
<p>Lizenz:</p>
|
|
<ul>
|
|
<li>Der Quellcode steht unter der GNU Gerneral Public License Version 2 und später, siehe <a href="https://github.com/OpencachingDeutschland/oc-server3/tree/stable/doc/license.txt">https://github.com/OpencachingDeutschland/oc-server3/tree/stable/doc/license.txt</a>.</li>
|
|
<li>
|
|
Für Daten, die über das XML-Interface abgerufen werden, gelten die
|
|
Nutzungsbedingungen von Opencaching.de: <a href="http://www.opencaching.de/articles.php?page=impressum#tos">
|
|
http://www.opencaching.de/articles.php?page=impressum#tos</a></li></ul>
|
|
<p> </p>
|
|
</span>
|
|
</body>
|
|
</html>
|