Aide > API pour développeurs

Sujets

API pour développeurs

Si vous êtes développeur, vous pouvez aller encore plus loin avec KreuZZ grâce à son API. Avec elle, vous pouvez gérer vos favoris d'une manière très simple.
Tous les appels à l'API se font en méthode GET à l'url de base http://www.kreuzz.com/api/ et les résultats sont retournés sous forme de XML.

L'identification se fait par la méthode HTTP-AUTH, c'est à dire qu'il vous faut passer le login et le mot de passe dans l'url comme suit :

http://login:password@www.kreuzz.com/api/

Voici les différentes méthodes que vous avez à votre disposition :

Opérations sur les tags :


http://www.kreuzz.com/api/links/tags/get/

Action :
Retourne tous les tags utilisés sur la bibliothèque des favoris.
Arguments :
- include_private (optionnel) valeur : 0 ou 1
Exemple : 
URL : http://www.kreuzz.com/api/links/tags/get/
<tags>
	<tag count="2" tag="adminsys"/>
	<tag count="1" tag="array de tags"/>
	<tag count="2" tag="bd"/>
	<tag count="20" tag="blog"/>
	<tag count="2" tag="cocktails"/>
<tags>


Opérations sur les favoris :


- http://www.kreuzz.com/api/links/bookmarks/get/

Action :
Liste tous les favoris correspondant aux critères de recherche. Si aucune date n'est spécifiée, la date du dernier ajout est sélectionnée..
Arguments :
- tag (optionnel) : filtre sur ce tag
- dt (optionnel) : filtre sur cette date, format AAAA-MM-JJ
- url (optionnel) : filtre sur cette url
Exemple : 
URL : http://www.kreuzz.com/api/links/tags/get/?dt=2006-10-03

<bookmarks>
	<bookmark id="257" href="http://jessysapho.blogspot.com/2006/10/prservons-nos-pots-dchappement.html" 
        title="Préservons nos pots d'échappement" description="" tags="blog,fun" date_added="2006-10-03T01:15:03+02:00" private="0"/>
	<bookmark id="256" href="http://www.eskuel.net/blog/2006/10/02/839-de-la-lecture-en-perspective/" 
        title="De la lecture en perspective" description="" tags="blog,interest" date_added="2006-10-03T01:03:57+02:00" private="0"/>



- http://www.kreuzz.com/api/links/bookmarks/recent/

Action :
Retourne la liste des derniers favoris ajoutés. Max : 100.
Arguments :
- tag (optionnel) : filtre sur ce tag
- count (optionnel) : nombre de favoris à retourner
- include_private (optionnel) valeur : 0 ou 1
Exemple : 
URL : http://www.kreuzz.com/api/links/bookmarks/recent/?count=2

<bookmarks tag="">
	<bookmark id="188" href="http://www.le-cuisinier.net/" title="Recettes de cuisine" 
        description="" tags="cocktails,cuisine,recettes" date_added="2005-10-21T10:42:12+02:00" private="0"/>
	<bookmark id="195" href="http://www.meyerweb.com/" title="meyerweb.com" 
        description="" tags="blog,CSS" date_added="2005-10-19T11:58:00+01:00" private="0"/>
</bookmarks>



- http://www.kreuzz.com/api/links/bookmarks/dates/

Action :
Retourne la liste des dates des ajouts de favoris, ainsi que le nombre de favoris.
Arguments :
- tag (optionnel) : filtre sur ce tag
Exemple : 
URL : http://www.kreuzz.com/api/links/bookmarks/dates/

<dates tag="">
	<date count="3" date="2006-10-31"/>
	<date count="2" date="2006-10-03"/>
</dates>



- http://www.kreuzz.com/api/links/bookmarks/all/

Action :
Liste tous les favoris.
Arguments :
- tag (optionnel) : filtre sur ce tag
- include_private (optionnel) : Inclus les liens privés, valeur : 0 ou 1
Exemple : 
URL : http://www.kreuzz.com/api/links/bookmarks/all/

<bookmarks>
	<bookmark id="195" href="http://www.meyerweb.com/" title="meyerweb.com" description="" 
        tags="blog,CSS" date_added="2005-01-05T11:58:00+01:00" private="0"/>
	<bookmark id="196" href="http://csszengarden.com/" title="css Zen Garden: The Beauty in CSS Design" description=""
        tags="CSS" date_added="2005-01-05T11:57:47+01:00" private="0"/>
</bookmarks>



- http://www.kreuzz.com/api/links/bookmarks/update/

Action :
Retourne la date de dernière mise à jour de la bibliothèque de favori, format ISO 8601.
Exemple : 
URL : http://www.kreuzz.com/api/links/bookmarks/update/

<update time="2006-10-31T22:37:03+01:00"/>



- http://www.kreuzz.com/api/links/bookmarks/add/

Action :
Ajoute un favori à bibliothèque utilisateur.
Arguments :
- url (requis) : URL de la page à ajouter
- title (requis) : Titre du favori
- tag (requis) : Tag(s) associé(s), séparés par des virgules
- description (optionnel) : Description du favori
- private (optionnel) : Ajouter comme lien privé, valeur : 0 ou 1
Exemple : 
URL : http://www.kreuzz.com/api/links/bookmarks/add/?url=http%3A%2F%2Fgoogle.com%2F&title=Google&tag=search,engine

<result code="done" />



- http://www.kreuzz.com/api/links/bookmarks/delete/

Action :
Supprime un favori de la bibliothèque utilisateur.
Arguments :
- url (requis)
Exemple : 
URL : http://www.kreuzz.com/api/links/bookmarks/delete/?url=http%3A%2F%2Fwww.google.com%2F

<result code="done" />