Generelle Informationen

Anfragen werden per HTTP an den server www.yigg.de geschickt. Die URL für die XML-RPC Anfragen ist: http://www.yigg.de/rpc/?API_KEY=DEIN_API_KEY wobei DEIN_API_KEY für deinen API-key steht.
Nur für die Funktion "addStory" braucht man den API-KEY. Die beiden anderen Funktionen funktionieren (derzeit) auch ohne.

Funktionen

addStory

Parameter: array
Rückgabetyp: String
Das array hat 5 Pflichtelemente, und ein optionelles.
  1. Der Permalink zur Story
  2. Der Titel der YiGG-Story
  3. Die Zusammenfassung
  4. Ein Array, bestehend aus den Tags die der Artikel haben soll
  5. Die Kategorie (vermutlich)...
  6. Der Modus (optionell)
Alles wird als string übergeben, ausser das Array (jedes Tag ist allerdings wiederum ein string) und die Kategorie. Die wird als Integer übergeben. Welche Kategorie zu welchem Integer gehört lässt sich mit getCategories() herausfinden. Der Modus ist ebenfalls ein Integer.
Der Modus ist ein Integer, derzeit werden 3 verschiedene Modi unterstützt.i
  1. plain
  2. html
  3. bbcode
Rückgegeben wird, wenn alles gut geht und der Artikel eingestellt wird, die URL zum Artikel allerdings ohne http://www.yigg.de/

autocompleteTag

Parameter: string
Rückgabetyp: array mit strings
Gibt ein Array, bestehend aus Strings zurück mit Tags die mit dem übergeben Parameter beginnen.

getCategories

Parameter: keine
Rückgabetyp: array bestehend aus structs (die aus einem int und einem string bestehen)
Gibt ein Array mit Structs zurück.
Jedes struct stellt eine Kategorie dar und hat zwei Felder: 'id' und 'name'. 'id' ist die ID der Kategorie und ein Integer, 'name' ist der Name der Kategorie (also ein String)

Beispiele mit Python

Zum Start:
import xmlrpclib
api_key = 'blablabla' # Dein API-key
my_yigg = xmlrpclib.ServerProxy('http://www.yigg.de/rpc/?API_KEY='+api_key, encoding="ISO-8859-1")
Und ein Funktionsaufruf mit jeder Funktion... (Achtung: addStory fügt eine neue Story zum YiGG-System ein, wenn meine Dokumentation hier stimmt und du keine Fehler machst :-D)... also spiel bitte nicht dumm damit herum... wenn du nur probieren willst, nimm die unteren beiden Funktionen ;)
foo = my_yigg.addStory(u'http://www.google.com', u'Dort ist deine Privatsphäre', u'Ja..dort ist sie...deine Privatsphäre',  ['google', u'privatsphäre', u'xml-rpc'], 1)
print foo
Und zu den ungefährlichen Funktionen (die nichts am YiGG-System ändern, bis auf ein bisserl den Server zu nerven...) 
print my_yigg.autocompleteTag('pha')
getCategories() ist hier nicht als Beispiel angeführt, es übernimmt keine Parameter, dürfte also recht einfach selber herauszufinden zu sein...
Alle Angaben natürlich ohne Gewähr ;-) Das ganze wurde zuletzt am 13. Juni 2007 getestet.