API - send/receive API version as header
Maintainer thường phản hồi trong vòng 7 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
- Đình trệ
- Lĩnh vực
- api, backend-api-design
Hướng nghiên cứu
Bắt đầu bằng việc đọc changelog phiên bản trong docs/CALENDAR_API.md. Làm rõ liệu các request và response có sử dụng các phiên bản major hay không, mã trạng thái nào được áp dụng cho các phiên bản không được hỗ trợ, và liệu server có mặc định sử dụng phiên bản mới nhất hay không. Được coi là hoàn tất khi hành vi thương lượng phiên bản đã thống nhất được ghi lại và triển khai cùng với proof of concept cho v1 và v2.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
The API should include the version number as a header in responses, e.g.
API-Version: 3
(Major version number only?)
Clients would also be encouraged (though not required) to include the version they're using in requests. If the client doesn't specify, the server would assume the latest version. In the future we may rev the version and introduce breaking changes, so clients should send the version they're expecting to ensure a predictable response.
As a proof of concept for handling different versions, we could check for v1 or v2 requests and reject those. (There should be no real requests for those versions, because those version numbers were defined post-hoc well after we were already on v3.) Error status code could be 400, or possibly 406 (Not Acceptable).
- Ngôn ngữ chính
- JavaScript
- Star
- 30
- Fork
- 26
- Merge trung bình
- 6 ngày 23 giờ
- Pull request đã merge (30 ngày)
- 3
Chuẩn bị môi trường
- Có Dockerfile hoặc tệp Docker Compose
- Không có mẫu pull request
- Không có hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- 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.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của shift-org/shift-docs
-
Unknown --db values report a TypeError instead of the intended errorCó thể đã có người làm @gangster đã nhận 68 ngày trước. Đang mở
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 88/100
shift-org/shift-docs#1091 ·
Maintainer thường phản hồi trong vòng 7 ngày
-
validateRideLength accepts any Object.prototype key as a ride lengthCó thể đã có người làm @gangster đã nhận 68 ngày trước. Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
shift-org/shift-docs#1089 ·
Maintainer thường phản hồi trong vòng 7 ngày
-
Favorites page fetches every favorite because getDaily's guard is invertedCó thể đã có người làm @gangster đã nhận 68 ngày trước. Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
shift-org/shift-docs#1087 ·
Maintainer thường phản hồi trong vòng 7 ngày
-
sitemap.xml emits relative <loc> values, so search engines reject itCó thể đã có người làm @dduugg đã nhận 94 ngày trước. Đang mở
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 68/100
shift-org/shift-docs#1082 ·
Maintainer thường phản hồi trong vòng 7 ngày
-
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 58/100
shift-org/shift-docs#1072 ·
Maintainer thường phản hồi trong vòng 7 ngày
Tất cả issue của shift-org/shift-docs
Issue tương tự
-
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 65/100
-
[BUG] Tools returned by input processors get an empty context.agent.agentIdCó thể làm lại được Pull request cho issue này đã bị đóng mà không được merge. Đang mở@mastra/core effort:low impact:medium status: auto-triaged Tools
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
mastra-ai/mastra#26794 · 3 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
release:v5.34
Độ khó 1/5 1-3 giờ Mức phù hợp với người mới 88/100
Jason-Vaughan/TangleClaw#2365 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100
-
enhancement
Độ khó 1/5 1-3 giờ Mức phù hợp với người mới 85/100
holepunchto/hrpc-test#28 ·