Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Link Object (and Arazzo?): require referencing operation with unambiguous path template

Đang mở
#4,084 3 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ó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
48/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Ít trao đổi
Công nghệ
openapi
Lĩnh vực
api, documentation

Hướng nghiên cứu

Bắt đầu bằng cách đọc các định nghĩa về Link Object và Arazzo operationRef, sau đó so sánh chúng với hành vi của Paths Object và Path Item có thể tái sử dụng được mô tả trong đặc tả. Công việc được xem là hoàn tất khi đặc tả xác định rõ operationRef và operationId có thể trỏ đến các Path Item Objects được tái sử dụng hay không, cũng như cách xác định một đường dẫn yêu cầu không mơ hồ.

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

Mô tả

bug re-use: ref/id resolution

Assume paths /foo and /bar both have a Path Item Object that $ref the same external "complete" Path Item Object.

If a Link Object now operationRefs the get Operation Object within that external Path Item Object, which request should the client construct?

It could be both

  • GET /foo or
  • GET /bar

Proposal:

  • Add restriction to Link Object that operationRef and operationId MUST NOT reference a reusable/multi-used Path Item Object
  • Possibly: require that the operationRef value "goes through" a Paths Object
Ngôn ngữ chính
Markdown
Star
31.2k
Fork
9.2k
Merge trung bình
2 ngày 9 giờ
Pull request đã merge (30 ngày)
17

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

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 OAI/OpenAPI-Specification

Tất cả issue của OAI/OpenAPI-Specification

Issue tương tự

Thêm issue về Backend & API Design

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.