Khi tích hợp một hệ thống mới vào một nền tảng đã tồn tại nhiều năm như Open Journal Systems, thử thách lớn nhất không nằm ở việc gọi API — mà nằm ở việc dữ liệu hai bên chưa bao giờ được thiết kế để nói chuyện với nhau.
1. Luôn xây dựng lớp ánh xạ dữ liệu trung gian
Đừng gọi API trực tiếp từ logic nghiệp vụ. Một lớp mapping riêng giúp bạn xử lý sự khác biệt về schema mà không phải sửa code ở nhiều nơi khi API đối tác thay đổi.
2. Rate limit không phải là lỗi, mà là một ràng buộc thiết kế
Thay vì coi lỗi 429 là ngoại lệ hiếm gặp, hãy thiết kế hàng đợi xử lý tuần tự với exponential backoff ngay từ đầu. Nó giúp hệ thống ổn định hơn nhiều so với việc retry ngay lập tức.
- Hàng đợi (queue) xử lý tuần tự
- Backoff tăng dần theo cấp số nhân
- Log chi tiết từng lần gọi để tra soát
Một tích hợp tốt không phải là tích hợp không bao giờ lỗi, mà là tích hợp luôn biết cách phục hồi.
3. Luôn có cơ chế đồng bộ lại thủ công
Dù tự động hoá tốt đến đâu, hãy luôn để người dùng cuối có một nút 'gửi lại' rõ ràng. Niềm tin vào hệ thống đến từ khả năng kiểm soát, không chỉ từ độ chính xác.
