Hypertext Application Language (HAL) помогает в создании самодокументируемых API следующим образом:

• Позволяет включать гиперссылки в представление ресурса. 2 Свойство links перечисляет связанные с ресурсом ссылки. 2 Каждая ссылка включает rel (тип отношения) и href, которые клиенты могут использовать для взаимодействия с API. 2
• Делает документацию API доступной прямо из сообщений самого API. 4 Это позволяет разработчикам сразу переходить к API на основе HAL и исследовать его возможности без необходимости искать дополнительную документацию. 4
• Упрощает использование библиотек с открытым исходным кодом. 3 С API, использующим HAL, можно взаимодействовать с помощью JSON или XML. 3
• Делает управляемым развитие API. 1 Все изменения URL происходят за сценой, и пока список отношений остаётся тем же, изменения не вызывают сбоев на клиентской стороне. 1