> For the complete documentation index, see [llms.txt](https://guide-api-rest.marmicode.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide-api-rest.marmicode.fr/autres-specifications.md).

# 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.