HTTP Resource Modeling Wish List - adamcin/http-resource-modeling GitHub Wiki

Goals

  • Empower secure & scalable web service design across layers (app, reverse proxy/cache, CDN) and across tiers (consistent testability in DEV, TEST, Staging, and Prod)
  • Platform-independent format(s)
  • Encourage phased progression from coarse/readable URI spec (perhaps markdown based like API Blueprints) to fully expressive/dense HTTP DSL.

Notes

  • Can be mapped to Sling Resource Resolution rules

  • Expressive, extensible syntax for describing HTTP-accessible resources across application layers

  • URI Template (rfc6570) level 3 support (for Sling selectors, file extensions, query string maps)

  • URI Templates as resource identifiers

  • Resource Composition (Collections, Resource Types, Include-at-path)

  • 'Collection' is an aspect of a resource, which defines allowed children types, exception handling (403, 404, 405)

  • Resource Types w/imports

  • Spec merge by overlay