Vous êtes nouveau sur Developpez.com ? Créez votre compte ou connectez-vous afin de pouvoir participer !

Vous devez avoir un compte Developpez.com et être connecté pour pouvoir participer aux discussions.

Vous n'avez pas encore de compte Developpez.com ? Créez-en un en quelques instants, c'est entièrement gratuit !

Si vous disposez déjà d'un compte et qu'il est bien activé, connectez-vous à l'aide du formulaire ci-dessous.

Identifiez-vous
Identifiant
Mot de passe
Mot de passe oublié ?
Créer un compte

L'inscription est gratuite et ne vous prendra que quelques instants !

Je m'inscris !

Ketting : une API générique Hypermedia et une interface RESTFul
Pour JavaScript et TypeScript

Le , par vermine

77PARTAGES

10  0 
Ketting a pour objectif de devenir une API cliente générique Hypermedia (HATEOAS) pour JavaScript et TypeScript que ce soit via Node.js ou dans les navigateurs. Ce qui veut dire qu'il prend en charge un ensemble de fonctionnalités modernes que les services REST pourraient avoir. L'idée est également de fournir une interface RESTful permettant de suivre de manière stricte les bonnes pratiques REST.

La bibliothèque utilise l'API Fetch et supporte plusieurs formats de données :
  • HAL, pour Hypertext Application Language ;
  • JSON:API ;
  • Siren, une interface structurée pour représenter des entités ;
  • Web Linking (header HTTP Link), un modèle de relations entre les ressources et des types ;
  • les link HTML5.


L'auteur, Evert Pot, donne l'exemple suivant :

Code js : Sélectionner tout
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
  
const ketting = new Ketting('https://api.example.org/'); 
  
// Retrouver un lien avec rel="author". Cela pourrait être un "<link>" HTML5, 
// un "_links" HAL ou un "Link:" HTTP. 
const author = await ketting.follow('author'); 
  
// Obtenir l'état actuel. 
const authorState = await author.get(); 
  
// Modifier la propriété firstName de l'objet. 
authorState.firstName = 'Evert'; 
  
// Sauvegarder le nouvel état. 
await author.put(authorState);

Contrairement à la plupart des autres bibliothèques, Ketting ne se base pas sur les URI, mais sur les types de relations et les liens. Car un principe de base de la construction d'un bon service REST, est que les URI doivent être découvertes et non codées en dur dans une application.

Site officiel.

Une erreur dans cette actualité ? Signalez-le nous !