Autres Spécifications

Nous constatons que dès la conception d’une simple API ReST, de nombreux choix s’offrent à nous (et on se retrouve comme des gamins chez Toys R Us).

Pourquoi ces choix sont-ils si importants ?

Après tout, on pourrait imaginer qu’une bonne documentation suffit. Le problème dans ce cas est que l'on risque de rencontrer rapidement des obstacles avec les librairies, frameworks et connecteurs qui se basent fortement sur les conventions ReST.

Encore mieux que les conventions, il nous faudrait un standard couvrant le maximum parmi les points suivants :

  • Format des données.

  • Typing des ressources.

  • Linking.

  • Pagination.