Hypertext Application Language

Hypertext Application Language (HAL) est une convention pour définir l'hypermedia, tels que les liens vers des ressources externes, à l'intérieur de code JSON ou XML. C'est documenté dans un internet draft (un « travail en cours »), avec la dernière version 11 publiée le . Le standard est initialement proposé en spécifiquement pour être utilisé avec le JSON, mais est devenu accessible en deux versions JSON et XML. Chacun associé à des types MIME : application/hal+xml et application/hal+json[1].

HAL a été créé pour être simple à utiliser et facilement applicable dans différents domaines, sans imposer de prérequis sur la structure du projet. En maintenant un impact minimal, HAL permet aux développeurs de créer des bibliothèques polyvalentes qui peuvent être facilement intégrées dans toute API utilisant HAL.

Les APIs qui utilisent HAL simplifient leur utilisation en open source et permettent l'interaction avec d'autres API utilisant du JSON ou du XML. Une alternative serait de développer un format propriétaire, ce qui obligerait toutefois les développeurs à apprendre à utiliser ce format étranger[2].

Convention

HAL est structuré de manière à représenter les éléments selon deux concepts : Ressources et Liens. Les ressources comprennent des liens URI, des ressources intégrées, les données standards (que ce soit en JSON ou en XML) et des liens non-URI. Les liens possèdent une URI cible, ainsi que le nom du lien (appelé 'rel'), ainsi que des propriétés optionnelles conçues pour prendre en compte la dépréciation et la négociation de contenu.

Exemple

Voir aussi

Références

  1. Richardson et Ruby Mike Amundsen; foreword by Sam, RESTful Web APIs, O'Reilly, (ISBN 978-1-4493-5806-8), chap. 7
  2. « The Hypertext Application Language », sur stateless.group (consulté le )

Content Disclaimer

Informasi ini disarikan dari Wikipedia dan disajikan kembali untuk tujuan edukasi. Konten tersedia di bawah lisensi CC BY-SA 3.0. Kami tidak bertanggung jawab atas ketidakakuratan data yang bersumber dari kontribusi publik tersebut.

  1. The information displayed on this website is sourced in part or in whole from Wikipedia and has been adapted for the purpose of restating it. We strive to provide accurate and relevant information, however:
  2. There is no guarantee of absolute accuracy. Wikipedia is an open, collaborative project that can be edited by anyone, so information is subject to change.
  3. It is not intended to constitute professional advice. The content displayed is for informational and educational purposes only. For important decisions (e.g., medical, legal, or financial), please consult a professional.
  4. Content copyright. Wikipedia is licensed under the Creative Commons Attribution-ShareAlike License (CC BY-SA). This means that content may be reused with appropriate attribution and shared under a similar license.
  5. Responsible use. Any risk arising from the use of information from this website is entirely the responsibility of the user.