Khắc phục sự cố lỗi gọi API

Last updated: June 19, 2026

 

Bài viết này nhằm chia sẻ những trường hợp đã dẫn đến lỗi API đối với khách hàng. Phần lớn thời gian, khi Bộ phận Hỗ trợ L2L được liên hệ về một lệnh gọi API không thành công, một trong những nguyên nhân sau đây được xác định là thủ phạm. Bạn luôn có thể liên hệ với chúng tôi và chúng tôi sẵn lòng hỗ trợ khắc phục sự cố cùng bạn. 

Điều cũng nghiêm trọng là bạn phải có sự tham gia của bộ phận CNTT tại địa phương. Những thay đổi đối với mạng nội bộ hoặc tường lửa tại địa phương của khách hàng có thể dẫn đến lỗi trong khi trước đó các lệnh gọi API vẫn hoạt động bình thường. 

 

Khi một lệnh gọi API không thành công, nguyên nhân thường là một trong những lý do sau: 

1. Tường lửa nội bộ tại cơ sở của khách hàng đang chặn lệnh gọi API 

2. Địa chỉ IP đã thay đổi hoặc địa chỉ IP trước đây nằm trong danh sách cho phép không còn được cho phép 

3. Cú pháp lệnh gọi API không chính xác. Đây là trường hợp thường gặp, thường do: 

  • Thiếu tham số bắt buộc 
  • Tên hoặc mô tả được sử dụng trong lệnh gọi khi yêu cầu CODE 
  • Lệnh gọi hết thời gian chờ, thường do cố gắng truy xuất dữ liệu vượt quá 2.000 bản ghi 
  • Lệnh gọi hết thời gian chờ do lưu lượng API lặp lại và/hoặc cực kỳ cao 

Tường lửa hạn chế lưu lượng vì một trong nhiều lý do. Hãy hỏi nhân viên CNTT tại địa phương của bạn xem có trường hợp nào dưới đây đã xảy ra không: 

  • Địa chỉ IP thay đổi 
  • Lỗi cấu hình proxy 
  • Giấy phép hết hạn 
  • Thay đổi Chính sách tường lửa 

Dưới đây là danh sách thông tin cần cung cấp cho Bộ phận Hỗ trợ L2L để giúp chúng tôi khắc phục sự cố các lệnh gọi API không thành công nhanh hơn: 

  • Lệnh gọi API chính xác mà họ đã sử dụng 
  • Kết quả hoặc thông báo lỗi được trả về 
  • Lệnh gọi API này trước đây có hoạt động thành công không? 
  • Nó đã ngừng hoạt động khi nào? Việc cung cấp ngày và giờ cũng giúp đẩy nhanh quá trình khắc phục sự cố cho cả đội ngũ CNTT tại địa phương của bạn và Bộ phận Hỗ trợ L2L. 
  • Bạn đã liên hệ với nhân viên CNTT tại địa phương chưa? 
  • Bộ phận CNTT của bạn có thực hiện thay đổi nào đối với các địa chỉ IP nằm trong danh sách cho phép không?