Giới thiệu
Khi tôi lần đầu xây dựng trang dự án của mình, tôi đã kéo dữ liệu trực tiếp từ API GitHub. Mọi thứ hoạt động tốt ở chế độ địa phương, nhưng khi tôi triển khai nó lên một nền tảng hosting tĩnh, một vấn đề đã xuất hiện: giới hạn tần suất của API.
GitHub API chỉ cho phép một số lượng yêu cầu không xác thực nhất định mỗi giờ. Trên hosting tĩnh (như GitHub Pages), không có môi trường phía máy chủ để ẩn khóa API hoặc quản lý xác thực. Điều này có nghĩa là mỗi trình duyệt của khách truy cập đều truy cập trực tiếp vào API GitHub. Chỉ cần một vài khách truy cập là đủ để làm cạn kiệt giới hạn và làm hỏng nguồn cấp dữ liệu dự án.
Bài viết này sẽ hướng dẫn bạn cách vượt qua giới hạn API GitHub bằng cách xây dựng một hệ thống caching JSON tĩnh.
Kiến trúc giải pháp
Để giải quyết vấn đề này, tôi đã suy nghĩ lại về kiến trúc. Thay vì phụ thuộc vào các cuộc gọi API trực tiếp, tôi đã phát triển một hệ thống caching JSON tĩnh:
- Tạo script Node.js: Tôi viết một script Node.js (update-projects.js) để lấy thông tin từ API GitHub. Dữ liệu sau đó được lưu vào tệp static/projects.json.
- Tải dữ liệu từ tệp JSON: Phần frontend sẽ tải dữ liệu từ tệp JSON này thay vì gọi trực tiếp đến API.
Cập nhật dữ liệu
Để giữ cho dữ liệu luôn mới, tôi đã thêm một workflow GitHub Actions như sau:
- Chạy mỗi thứ Hai lúc nửa đêm theo UTC.
- Lấy những repository mới nhất.
- Cập nhật static/projects.json chỉ khi có sự thay đổi được phát hiện.
Workflow này sẽ commit và đẩy các cập nhật trở lại repo, điều này sẽ kích hoạt quá trình redeploy.
Lợi ích của phương pháp này
Phương pháp này mang lại cho tôi lợi ích của cả hai thế giới:
- Hosting tĩnh nhanh chóng và đáng tin cậy mà không gặp phải lỗi API.
- Dữ liệu mới tự động cập nhật theo lịch trình.
- Không có rủi ro về việc vượt quá giới hạn API cho khách truy cập.
Thực tiễn tốt nhất
- Sử dụng caching: Hệ thống caching giúp giảm thiểu các yêu cầu không cần thiết đến API, do đó tiết kiệm băng thông và tài nguyên.
- Lên kế hoạch cập nhật: Tạo lịch trình cập nhật cho dữ liệu để đảm bảo bạn luôn có thông tin mới nhất mà không phải lo lắng về việc vượt quá giới hạn.
- Theo dõi hiệu suất: Theo dõi thời gian phản hồi và tình trạng của API để điều chỉnh cách thức lấy dữ liệu kịp thời.
Những cạm bẫy thường gặp
- Bỏ qua việc kiểm tra lỗi: Đảm bảo rằng bạn kiểm tra lỗi khi thực hiện các cuộc gọi API. Nếu API không phản hồi, bạn cần có biện pháp xử lý phù hợp.
- Không lưu trữ dữ liệu cũ: Luôn lưu trữ dữ liệu cũ để bạn có thể phục hồi nếu có lỗi xảy ra trong khi cập nhật.
Mẹo hiệu suất
- Giảm kích thước dữ liệu: Chỉ lấy những dữ liệu cần thiết từ API để giảm tải cho hệ thống.
- Sử dụng các kỹ thuật nén: Giúp giảm thời gian tải trang cho người dùng.
Giải quyết sự cố
- Nếu dữ liệu không được cập nhật: Kiểm tra lại cron job của GitHub Actions để đảm bảo nó chạy đúng thời gian.
- Nếu gặp lỗi khi gọi API: Kiểm tra xem có vấn đề gì với khóa API hay không, và đảm bảo rằng bạn không vượt quá giới hạn yêu cầu.
Kết luận
Những thách thức mà tôi gặp phải trong quá trình phát triển đã dẫn tôi đến một giải pháp tối ưu hơn. Việc kết hợp hosting tĩnh với tự động hóa đã giúp tôi tạo ra một trang dự án nhanh chóng, đáng tin cậy và luôn cập nhật. Hãy thử nghiệm giải pháp này cho dự án của bạn và tận hưởng lợi ích mà nó mang lại.
Câu hỏi thường gặp (FAQ)
1. Làm thế nào để tạo workflow GitHub Actions?
Bạn có thể tạo một tệp YAML trong thư mục .github/workflows của repo của mình.
2. Tôi có thể sử dụng caching cho API khác không?
Có, phương pháp này có thể áp dụng cho bất kỳ API nào với những điều chỉnh phù hợp.
3. Có cách nào khác để vượt qua giới hạn API không?
Có, bạn có thể sử dụng các dịch vụ proxy hoặc server-side để quản lý xác thực và giới hạn yêu cầu.
Hãy xem portfolio của tôi tại gitongacode.co.ke để biết thêm thông tin!
