| 7 | | Cette interface implémente deux "standards" : |
|---|
| 8 | | * le protocole de publication Atom ; |
|---|
| 9 | | * et le format de résultats de recherche ''open search''. |
|---|
| 10 | | |
|---|
| 11 | | Le protocole Atom est utilisé pour gérer le processus de publication des marks et des commentaires par les utilisateurs. |
|---|
| 12 | | |
|---|
| 13 | | Le format ''open search'' est utilisé au sein des flux résultats. |
|---|
| | 7 | Cette interface suit deux "standards" : |
|---|
| | 8 | * le [http://bitworking.org/projects/atom/draft-ietf-atompub-protocol-09.html Protocole de Publication Atom] pour gérer le processus de publication des marks et des commentaires ; |
|---|
| | 9 | * et le format [http://opensearch.a9.com/ Open Search] utilisé au sein des flux résultats. |
|---|
| 50 | | || http://rest.blogmarks.net/user/[username]/friends/marks || GET || Retourne le feed Atom des marks des amis de l'utilisateur. || |
|---|
| 51 | | || http://rest.blogmarks.net/marks || GET || Retourne le feed Atom des marks publics de tous les utilisateurs. || |
|---|
| 52 | | || http://rest.blogmarks.net/link/[hash]/marks || GET || Retourne le feed Atom des marks sur le lien. || |
|---|
| 53 | | || http://rest.blogmarks.net/link/[hash]/comments || GET || Retourne le feed Atom des commentaires sur le lien. || |
|---|
| | 49 | || {{{http://rest.blogmarks.net/user/{username}/friends/marks}}} || GET || Retourne le feed Atom des marks des amis de l'utilisateur. || |
|---|
| | 50 | || {{{http://rest.blogmarks.net/marks}}} || GET || Retourne le feed Atom des marks publics de tous les utilisateurs. || |
|---|
| | 51 | || {{{http://rest.blogmarks.net/link/{hash}/marks}}} || GET || Retourne le feed Atom des marks sur le lien. || |
|---|
| | 52 | || {{{http://rest.blogmarks.net/link/{hash}/comments}}} || GET || Retourne le feed Atom des commentaires sur le lien. || |
|---|
| 75 | | * atom : http://www.w3.org/2005/Atom |
|---|
| 76 | | * app : http://purl.org/atom/app# |
|---|
| 77 | | * bm : http://blogmarks.net/ns |
|---|
| | 74 | * atom : {{{http://www.w3.org/2005/Atom}}} |
|---|
| | 75 | * app : {{{http://purl.org/atom/app#}}} |
|---|
| | 76 | * bm : {{{http://blogmarks.net/ns}}} |
|---|
| | 77 | |
|---|
| | 78 | || '''Nom''' || '''Description''' || '''Modifiable par l'utilisateur''' || |
|---|
| | 79 | || atom:id || Identifiant unique du mark, ne changera pas. || || |
|---|
| | 80 | || atom:title || Le titre du mark. || x || |
|---|
| | 81 | || atom:link[@rel=related] || Le lien décrit par le bookmark. || x || |
|---|
| | 82 | || atom:link[@rel=alternate] || Le lien vers la représentation HTML du mark (sur l'interface web). || || |
|---|
| | 83 | || atom:published || La date de création du mark. || x || |
|---|
| | 84 | || atom:updated || La date de dernière modification du mark. || || |
|---|
| | 85 | || atom:author || Auteur du mark. || || |
|---|
| | 86 | || atom:link[@rel=via] || Referer lorsque l'utilisateur a ajouté le lien à ses marks. || x || |
|---|
| | 87 | || atom:link[@rel=enclosure] || Url du screenshot du lien que décrit le mark. || x || |
|---|
| | 88 | || atom:category || Tag associé au mark. || x || |
|---|
| | 89 | || atom:content || Description du lien posté. || x || |
|---|
| | 90 | || || || |
|---|
| | 91 | || app:link[@rel=edit] || Indique que le mark est éditable et donne l'URI pour le modifier ou le supprimer. || || |
|---|
| | 92 | || || || |
|---|
| | 93 | || bm:link[@rel=comments] || Url du feed Atom des commentaires sur le lien du mark. || || |
|---|
| | 94 | || bm:isPrivate || Indique si le mark est privé ou non. || x || |
|---|
| | 95 | |
|---|
| | 96 | === Commentaire === |
|---|
| 80 | | || atom:id || Identifiant unique du mark, ne changera pas. || |
|---|
| 81 | | || atom:title || Le titre du mark. || |
|---|
| 82 | | || atom:link[@rel=related] || Le lien décrit par le bookmark. || |
|---|
| 83 | | || atom:link[@rel=alternate] || Le lien vers la représentation HTML du mark (sur l'interface web). || |
|---|
| 84 | | || atom:published || La date de création du mark. || |
|---|
| 85 | | || atom:updated || La date de dernière modification du mark. || |
|---|
| 86 | | || atom:author || Auteur du mark. || |
|---|
| 87 | | || atom:link[@rel=via] || Referer lorsque l'utilisateur a ajouté le lien à ses marks. || |
|---|
| 88 | | || atom:link[@rel=enclosure] || Url du screenshot du lien que décrit le mark. || |
|---|
| 89 | | || atom:category || Tag associé au mark. || |
|---|
| 90 | | || atom:content || Description du lien posté. || |
|---|
| 91 | | || || || |
|---|
| 92 | | || app:link[@rel=edit] || Indique que le mark est éditable et donne l'URI pour le modifier ou le supprimer. || |
|---|
| 93 | | || || || |
|---|
| 94 | | || bm:link[@rel=comments] || Url du feed Atom des commentaires sur le lien du mark. || |
|---|
| 95 | | || bm:isPrivate || Indique si le mark est privé ou non. || |
|---|
| | 99 | || atom:id || Identifiant unique du commentaire, ne changera pas. || |
|---|
| | 100 | || atom:link[@rel=related] || Le lien sur lequel est le commentaire. || |
|---|
| | 101 | || atom:link[@rel=alternate] || Le lien vers la représentation HTML du commentaire (sur l'interface web). || |
|---|
| | 102 | || atom:published || La date de publication du commentaire. || |
|---|
| | 103 | || atom:author || Auteur du commentaire || |
|---|
| | 104 | || atom:content || Contenu du commentaire || |
|---|
| | 105 | |
|---|
| | 106 | == Les autres types de ressources == |
|---|
| | 107 | |
|---|
| | 108 | Blogmarks met à disposition des développeurs d'autres types de ressources mais toujours selon une architecture REST. |
|---|
| | 109 | |
|---|
| | 110 | === Les tags === |
|---|
| | 111 | |
|---|
| | 112 | Les tags permettent aux utilisateurs de classer leurs marks. |
|---|
| | 113 | |
|---|
| | 114 | ==== Deux types de ressources ==== |
|---|
| | 115 | |
|---|
| | 116 | Collection de tags : |
|---|
| | 117 | * {{{http://rest.blogmarks.net/tags}}} : tags publics |
|---|
| | 118 | * {{{http://rest.blogmarks.net/user/{username}/tags}}} : tags utilisés par ''username'' |
|---|
| | 119 | |
|---|
| | 120 | Un tag : |
|---|
| | 121 | * {{{http://rest.blogmarks.net/tags/{id}}}} dont on peut récupérer une représentation par la méthode GET. |
|---|
| | 122 | |
|---|
| | 123 | ==== Format ==== |
|---|
| | 124 | |
|---|
| | 125 | @TBD@ |
|---|