APPNETOS is under active development This website and its documentation are being prepared for public launch. Content and features may change.
Select Theme
Loading

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.

Next Steps

REST Collections

Explore REST Collections

Request & Response

Explore Request & Response

Security & CORS

Explore Security & CORS

OpenAPI Generator

Explore OpenAPI Generator

Swagger UI

Explore Swagger UI