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

docs: correctly specifying which fields will be present in Webhook API responses

Đang mở
#749 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ó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
45/100
Loại issue
Tài liệu
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Đình trệ
Công nghệ
openapi
Lĩnh vực
api, documentation

Hướng nghiên cứu

Bắt đầu với tài liệu API “Get all webhooks” được liên kết và tìm schema phản hồi OpenAPI tương ứng. Kiểm tra những trường phản hồi nào được yêu cầu phải có thay vì có thể là nullable, sau đó cập nhật tài liệu hoặc schema để các trường bắt buộc được biểu diễn chính xác và xác minh tài liệu tham chiếu API đã render.

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

Mô tả

documentation

Request for updates in the documentation

  • [ ] New Documentation
  • [x] Updates to Existing Documentation

I was looking at the Get all webhooks API: https://www.alchemy.com/docs/data/webhooks/webhooks-api-endpoints/notify-api-endpoints/team-webhooks and noticed that all fields can be nullable.

Is this intented? Can we add required in OpenAPI spec, since in version v3.1.0 not adding required means it can be optional?

Image
Ngôn ngữ chính
MDX
Star
8
Fork
18
Merge trung bình
21 giờ 8 phút
Pull request đã merge (30 ngày)
45

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 alchemyplatform/docs

Tất cả issue của alchemyplatform/docs

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.