Avis Subjectif sur H.A.T.E.O.A.S. et le Semantic Web
Supposons que nous disposions des objets et méthodes suivantes :
1
/* GET https://v1.api.wishtack.com/users/SOME_USER_ID */
2
userStore.getUser({userId: 'SOME_USER_ID'});
3
4
/* GET https://v1.api.wishtack.com/users/SOME_USER_ID/wishes */
5
wishStore.getWishList({userId: 'SOME_USER_ID'});
Copied!
Supposons maintenant que l’API réponde avec les données suivantes :
1
{
2
"href": "https://v1.api.wishtack.com/users/SOME_USER_ID",
3
"wishes": {
4
"href": "https://v1.api.wishtack.com/users/SOME_USER_ID/wishes"
5
}
6
}
Copied!
Comment faire pour réutiliser la méthode WishStore.getWishList ?
Faut-il ajouter une méthode WishStore.getWishListByUrl ?
Que faire en cas d’incohérence ?
  • Les données ne sont pas proprement canonicalisées.
  • Les URLs sont dupliquées et occupent une grande partie du contenu. Comment factoriser ?
  • Comment récupérer l'"id" si on ne souhaite pas utiliser le "href" comme "id".
  • Une URL est une information qui perd en canonicalisation. Une façon plus canonique de décrire une ressource serait la suivante :
    1
    {
    2
    "baseUrlList": ["https://api.wishtack.com", "https://api-backup.wishtack.com"],
    3
    "resourcePath": [
    4
    {"id": "USER_ID", "type": "user"},
    5
    {"id": "WISH_ID", "type": "wish"}
    6
    ]
    7
    }
    Copied!
  • Comment basculer automatiquement d’une API principale à une API de backup sans “parser” et reconstruire l’URL ?
  • Peut-on faire confiance à une API au point d’utiliser naïvement les URLs qu’elle nous transmet ?
  • Il nous faudrait idéalement les informations suivantes :
    • id de la ressource.
    • type de la ressource ou encore mieux un référentiel de type. I.A.N.A. ?
    • Mapping type => informations sur la construction de l’URL (Base URL et Path).
    • Affordances : que puis-je faire avec la ressource ? A quoi correspond-elle ?
C’est tout simplement l’utopie du Web Sémantique, parfaitement adaptée à des ressources génériques mais à peu d'applications. Cela nécessite des standards de canonicalisation des données et une adoption importante.
Application-Level Profile Semantics : http://alps.io/spec/drafts/draft-01.html
Alps
Alps
Copier le lien