REST & OpenAPI
Build APIs in PHP. Document them automatically. Explore them interactively.
APPNETOS connects annotation-driven REST resources with context-aware routing, integrated security and automatically generated OpenAPI specifications. Your API definition stays close to the code that implements it — without maintaining a separate specification by hand.
From application code to a documented API
REST endpoints are defined in application-specific collection classes through PHP annotations. APPNETOS resolves the resources for the active application and context, routes supported HTTP methods and exposes their metadata to the OpenAPI generator.
Annotation-driven
Describe REST resources where they belong: in PHP, alongside their implementation.
Context-aware
Keep application REST interfaces separated by their configured runtime contexts and routes.
Documented automatically
Generate OpenAPI definitions from the registered REST resources and their metadata.
One workflow, from implementation to testing
| Step | APPNETOS capability | Developer benefit |
|---|---|---|
| Define | REST collection and annotation | Resource configuration stays with the PHP implementation. |
| Route | Application/context-aware REST routing | Endpoints resolve within the correct application boundary. |
| Protect | Security configuration and CORS | Control authentication and cross-origin access. |
| Generate | OpenAPI generator | Publish a machine-readable API description. |
| Explore | Swagger UI in appnetos-api-dev |
Inspect operations and execute interactive requests. |
Designed for real application boundaries
APPNETOS does not treat every endpoint as part of a single global API. REST resources are resolved in
the
active application and configured context, allowing different applications to expose their own
interfaces. The implemented rest and admin-rest contexts support this
separation today.
REST resources can handle the supported HTTP methods GET, POST,
PUT, PATCH and DELETE. Security settings can include Basic or
Bearer authentication, while CORS configuration controls permitted cross-origin access for the
relevant
application/context.
The separately planned api and
admin-api
contexts are not described here as implemented features.
OpenAPI without duplicate documentation work
The OpenAPI generator uses the REST definitions and available metadata to produce specifications for the configured application contexts. These specifications make API endpoints easier to inspect, share and integrate with development tools.
For hands-on testing, appnetos-api-dev provides a Swagger UI interface that discovers generated definitions and lets developers inspect and call documented endpoints. This closes the loop between implementation, documentation and verification.