Helpdesk API Architecture

Audience

Developers, QA, security, support and architects.

Summary

Helpdesk exposes canonical and legacy-shaped Minimal API route groups in one service. Gateway reverse-proxy routing handles compatibility ownership, while employee gateway handlers call canonical ticket operations directly.

Reference Content

The service also maps a framework health probe and shared root service-information response. Swagger/OpenAPI generation is registered, but no explicit API-versioning component is configured.

Requires confirmation

Which callers may access direct routes, production gateway ownership, generated OpenAPI publication and future API ownership require confirmation.

Source References

• microservices/src/helpdesk-service/Api/HelpdeskEndpoints.cs
• microservices/src/helpdesk-service/Program.cs
• microservices/src/gateway-api/Program.cs
• microservices/src/gateway-api/EssEndpoints.cs

Related Articles

• API overview
• Endpoint catalog
• API limitations

See Also

• Technical documentation
• Helpdesk business documentation

Keywords

API architecture, native endpoints, compatibility endpoints, gateway.

Revision Information

• Status: Draft
• Last reviewed: 2026-07-20
• Next review: 2026-10-20