[REQ] /api-descriptions to return possible set of enums supported or other data type definitions to client rather than relying on previously agreed on spec

Đang mở
#25,093 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
25/100
Loại issue
Tính năng
Độ rõ ràng
Cần làm rõ
Mức độ hoạt động
Sôi nổi
Công nghệ
java, openapi
Lĩnh vực
api, backend-api-design

Hướng nghiên cứu

No files, tests, or entry points are named. Start by reviewing how OpenAPI Generator represents endpoint request and response schemas, then define the generic /api-descriptions format and how generated clients would fetch it; done means every endpoint exposes usable enum and data-type definitions before requests are modeled.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

Enhancement: Feature
Is your feature request related to a problem? Please describe.

Adding more enums to list or refactoring existing enum need to share new version with every consumer.

Describe the solution you'd like

Expose a generic /api-descriptions path on all end points so client can fetch details before calling an api and model request accordingly.

Describe alternatives you've considered

Not considered any open to discussions

Additional context

NA

Ngôn ngữ chính
Java
Star
26.9k
Fork
7.8k
Merge trung bình
2 ngày 10 giờ
Pull request đã merge (30 ngày)
180

Chuẩn bị môi trường

Mở trong Codespaces

Khởi chạy dev container của dự án ngay trên trình duyệt, bằng tài khoản GitHub của bạn.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của OpenAPITools/openapi-generator

Tất cả issue của OpenAPITools/openapi-generator

Issue tương tự

Thêm issue về Java

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.