Hilfe

Wichtig: Benutzer muss eingeloggt sein!

Aufruf: api/write/?call=[funktion]&... 

Funktion add_cache
Cache für CJ:Engine hinzufügen

Parameter
waypoint -> Waypoint

Rückgaben
cacheid -> CJ ID des Caches
state -> Status des Caches (New, Synced, Fail, ResyncRequested)



Funktion rate
Kategorien bewerten

Parameter
cacheid -> CJ ID des Caches
[Ratekey] -> Systemname der Bewertungskategorie

Rückgaben
ratings -> Auflistung der aktuellen Bewertung

Ratekeys - Beschreibung
ListingDifficulty - Mit diesem Faktor wird festgelegt, ob die Schwierigkeits-Einschätzung des Owners angebracht ist.
ListingCoords - Sind die Koordinaten zum Cache zu ungenau, wären Parkplatzkoordinaten hilfreich gewesen?
ListingTerrain - Mit diesem Faktor wird festgelegt, ob die Terrain-Einschätzung des Owners angebracht ist.
MAF - Ist die Gegend sehr ruhig oder eher Marktplatzähnlich. Bewertet wird hier die Gefahr erwischt zu werden. (10 = Ruhige Gegend, 0 = Marktplatz).
Final - Hier kannst du bewerten wie dir die Lage, Aufbau und Umgebung des Finals gefallen haben.
CreativityFinal - Bildet der Final einen guten Abschluss der Story oder ist er in einem dramatischen Finale integriert? Oder ist es einfach nur eine Tupperdose, die etwas größer ist?
SWF - Hier wird kurz bewertet, ob die Gegend um den Cache besonders sehenswert ist und auch unabhängig vom Geocaching einen Besuch wert ist.
ListingHints - Hier wird bewertet, ob die Hints des Owners hilfreich genug sind, eher in die Irre führen, oder ob vielleicht überhaupt welche gemacht werden sollten.
Story - Ist die Gesamtstory des Caches kreativ ausgearbeitet oder bewegt man sich einfach stur von Station zu Station?
Reflectors - Hier kann erklärt werden, ob die Reflektoren eines Nachtcaches in gutem Zustand sind, ob die Abstände ausreichen und ob die Leuchtkraft im Allgemeinen genügen. Hat der Cache keine Reflektoren, dann lass die Bewertung bitte bei 5 Sternen.
Stations - Sind die einzelnen Stationen des Caches in gutem Zustand oder neigen sie zu Beschädigungen. Sind einige Positionen vielleicht unangebracht oder zu anfällig?
CreativityStations - Unterliegen die einzelnen Stationen auch einer Story, sind sie vielleicht persönlich aufgebaut, oder enthalten sie einfach nur Informationen?
SubjectiveRating - Hier hat der Bewerter die Möglichkeit, dem Cache noch eine Gesamtbewertung von 1 bis 10 zu geben, unabhängig von den bisherigen Faktoren. Rein subjektiv also...
ListingCacheDesc - Hier stellt sich die Frage, ob die allgemeine Cache-Beschreibung des Owners ausreichend und hilfreich genug ist.

Beispiel
api/write/?call=rate&cacheid=xxx&ListingDifficulty=6&Stations=4&Reflectors=2 ...

Infos
Wird einem Ratekey kein Wert übergeben, wird die Standardbewertung übernommen (aktuell 5), wird ein unbekannter Wert erkannt, wird ebenfalls der Wert 5 übernommen
Die rate Funktion kann beliebig oft aufgerufen werden. Sie überschreibt die jeweils alten Werte.



Funktion add_comment
Ein Kommentar zu einer Bewertung hinzufügen

Parameter
cacheid -> CJ ID des Caches
comment -> Kommentar

Rückgaben
success -> 1/0

Infos
Ein Kommentar darf maximal 250 Zeichen aufweisen, jedes weitere wird abgeschnitten.



Funktion delete_comment
Den Kommentar zur Bewertung löschen

Parameter
cacheid -> CJ ID des Caches

Rückgaben
success -> 1/0



Funktion add_tags
Tags hinzufügen

Parameter
cacheid -> CJ ID des Caches
userid -> ID des Benutzers
tags -> Tags kommagetrennt

Rückgaben
success -> 1/0



Funktion clear_tags
Tags löschen

Parameter
cacheid -> CJ ID des Caches
userid -> ID des Benutzers

Rückgaben
success -> 1/0



Funktion enable_rating
Gesamtes Rating aktivieren

Parameter
cacheid -> CJ ID des Caches
userid -> ID des Benutzers

Rückgaben
success -> 1/0



Funktion get_rating
aktuelle Bewertungsdetails bekommen

Parameter
userid -> ID des Benutzers
cacheid -> CJ ID des Caches

Rückgaben
rating -> Bewertung der einzelnen Kategorien



Funktion get_state
Status des caches bekommen

Parameter
cacheid -> CJ ID des Caches

Rückgaben
state -> Status des Caches (New, Synced, Fail, ResyncRequested)
nightcache_state -> Nachtcacheflag (Y = Nachtcache, N = Normaler Cache, NA = Keine Angabe)