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