- Trong môi trường MSA, phát sinh vấn đề số lượng đặc tả API tăng lên tương ứng với số lượng miền dịch vụ
- Để giải quyết vấn đề này,
- Trong môi trường MSA, hiển thị tài liệu của nhiều dịch vụ khác nhau tại một URL duy nhất.
- Tìm cách tự động tạo trang tài liệu API
- Định nghĩa yêu cầu và kiến trúc
- Công cụ và đặc tả dùng để tích hợp tài liệu API
- Triển khai tích hợp tài liệu API
- Công việc mã nguồn cơ bản để đáp ứng đặc tả OpenAPI
- Trích xuất tài liệu API dưới dạng JSON
- Web hosting bằng GitHub Pages
- Tự động hóa bằng GitHub Actions
- Cách áp dụng tích hợp tài liệu API trong môi trường nhiều repository
1 bình luận
Để giải quyết một vấn đề tương tự, chúng tôi đang xây dựng một ứng dụng web thu thập tài liệu Swagger API và hiển thị lại chúng bằng Swagger UI, rồi công bố dưới dạng mã nguồn mở. https://github.com/stray-cat-developers/giant-otter Nếu bạn cũng đang có trăn trở tương tự thì có lẽ nên thử sử dụng nó.