HONMA (HTTP Oriented Native Media Architecture) is a minimalist application protocol for Web communication interfaces built on top of HTTP. Born in the peaceful Honmachi district of Osaka, it embodies the Japanese philosophy of minimalism and efficiency.
- Simplicity: Like Japanese zen gardens, HONMA keeps only the essential elements
- Built on Standards: Leverages existing HTTP mechanisms and REST architectural style
- Constraint-Driven Design: A minimal set of rules that promote API consistency
- Native Web Integration: Works harmoniously with HTTP conventions and semantics
The specification is currently available in French:
- Philosophy - Explores HONMA's design principles and philosophy
- Specification - Technical specification of the protocol
- Examples - Concrete examples showing HONMA in action
(English documentation coming soon)
- Resource representation through collections and individual members
- Navigation via HTTP Link headers
- Resource discovery using HTTP OPTIONS
- Content negotiation through HTTP Accept headers
- Consistent error handling
- Built-in support for caching and concurrent modifications
We welcome contributions! Please feel free to submit issues and pull requests.
This project is licensed under the MIT License - see the LICENSE file for details.
https://github.com/honma-protocol/spec
🚧 Currently in active development. The specification is stabilizing but may still evolve based on implementation feedback.