Skip to content

TASK: Aggregate service OpenAPI definitions through API Gateway #83

Closed

Description

@ramioooz

Parent: STORY: Establish API contract and documentation standards

Provide a central documentation interface without combining service-owned contracts into one file.

Acceptance criteria

  • API Gateway hosts the central Swagger UI at /admin/docs/swagger-ui.html.
  • The UI provides a named selector for Customer Service and Account Service.
  • Each definition remains owned and versioned by its service.
  • Internal-only contracts are not exposed through public routes.
  • Behavior is verified when one documentation backend is unavailable: the gateway remains healthy and other documentation routes remain usable while the unavailable route returns a controlled 5xx.

Activity

  1. added theissue type on Aug 2, 2026
  2. self-assigned this
    on Aug 3, 2026
  3. ramioooz commented on Aug 3, 2026

    @ramioooz
    MemberAuthor

    Implementation PR: https://github.com/digital-bank-java/api-gateway/pull/19\n\nIt verifies that an unavailable documentation backend produces a controlled 5xx without taking down gateway health or other routes.

  4. ramioooz commented on Aug 3, 2026

    @ramioooz
    MemberAuthor

    Centralized Gateway OpenAPI aggregation and unavailable-backend verification completed through api-gateway#19.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions