> ## Documentation Index > Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt > Use this file to discover all available pages before exploring further. # Câu hỏi thường gặp về mã lỗi > Khắc phục sự cố mã lỗi HTTP khi sử dụng các điểm cuối RPC của Helius — xác định và giải quyết các vấn đề phổ biến nhất về xác thực, giới hạn tốc độ và máy chủ ## Ý nghĩa của lỗi này **401 Unauthorized** - Yêu cầu của bạn không có thông tin xác thực hợp lệ. ## Nguyên nhân phổ biến * API key không hợp lệ hoặc bị thiếu * API key được đặt sai vị trí * Quy tắc kiểm soát truy cập đang chặn yêu cầu của bạn * API key đã hết hạn hoặc bị thu hồi ## Giải pháp 1. **Xác minh định dạng API key** ``` https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY ``` 2. **Kiểm tra vị trí đặt API key** * Đảm bảo API key nằm trong các tham số truy vấn * Xác minh rằng không có khoảng trắng hoặc ký tự thừa 3. **Xem lại Quy tắc kiểm soát truy cập** * Kiểm tra [cài đặt bảng điều khiển](https://dashboard.helius.dev/) để biết các hạn chế về IP * Đảm bảo miền của bạn có trong danh sách cho phép nếu sử dụng yêu cầu từ trình duyệt Để biết cách thiết lập xác thực chi tiết, hãy xem hướng dẫn [Xác thực](/docs/vi/api-reference/authentication) của chúng tôi. ## Ý nghĩa của lỗi này **429 Too Many Requests** - Bạn đã vượt quá giới hạn tốc độ của gói dịch vụ. ## Nguyên nhân phổ biến * Gửi yêu cầu nhanh hơn mức gói dịch vụ cho phép * Lưu lượng tăng đột biến vượt quá giới hạn tức thời * Nhiều ứng dụng dùng chung một API key * Mã nguồn kém hiệu quả gửi các yêu cầu dư thừa ## Giải pháp 1. **Theo dõi mức sử dụng** * Kiểm tra biểu đồ `Rate Limited Requests` trong [bảng điều khiển](https://dashboard.helius.dev/usage) * Xem lại những điểm cuối nào đang chạm giới hạn 2. **Tối ưu hóa yêu cầu** * Lưu phản hồi vào bộ nhớ đệm khi có thể * Gộp nhiều thao tác vào một lệnh gọi duy nhất * Loại bỏ việc thăm dò không cần thiết hoặc các yêu cầu trùng lặp 3. **Triển khai giới hạn tốc độ** * Thêm khoảng trễ giữa các yêu cầu trong ứng dụng * Sử dụng chiến lược thời gian chờ tăng theo cấp số nhân khi thử lại 4. **Cân nhắc nâng cấp** * Xem [Gói dịch vụ và giới hạn tốc độ](/docs/vi/billing/plans) để biết các cấp cao hơn Giới hạn tốc độ được đặt lại mỗi phút, vì vậy tình trạng hạn chế tạm thời thường được giải quyết nhanh chóng. ## Ý nghĩa của lỗi này **500 Internal Server Error** - Đã xảy ra lỗi phía máy chủ trong khi xử lý yêu cầu của bạn. ## Nguyên nhân phổ biến * Payload của yêu cầu không đúng định dạng * Máy chủ đang gặp sự cố tạm thời * Tham số không hợp lệ gây ra lỗi máy chủ * Sự cố kết nối mạng ## Giải pháp 1. **Xác thực yêu cầu** * Đảm bảo payload JSON được định dạng đúng * Xác minh rằng tất cả tham số bắt buộc đều đã được cung cấp * Kiểm tra kiểu tham số có khớp với đặc tả API hay không 2. **Kiểm tra trạng thái dịch vụ** * Truy cập [Trang trạng thái Helius](https://helius.statuspage.io/) để xem các sự cố đang diễn ra * Kiểm tra mọi báo cáo về tình trạng gián đoạn hoặc suy giảm hiệu suất 3. **Triển khai logic thử lại** * Chờ vài giây trước khi thử lại * Sử dụng chiến lược thời gian chờ tăng theo cấp số nhân cho nhiều lần thử 4. **Yêu cầu hỗ trợ** * Nếu lỗi vẫn tiếp diễn, hãy liên hệ bộ phận hỗ trợ và cung cấp thông tin chi tiết về yêu cầu * Cung cấp payload chính xác của yêu cầu và dấu thời gian Lỗi máy chủ thường chỉ là tạm thời và thường tự động được giải quyết. ## Ý nghĩa của lỗi này **503 Service Unavailable** - Máy chủ đang tạm thời quá tải hoặc được bảo trì. ## Nguyên nhân phổ biến * Lưu lượng truy cập cao gây quá tải tạm thời * Khoảng thời gian bảo trì theo lịch * Đã đạt giới hạn dung lượng máy chủ * Sự cố hạ tầng mạng ## Giải pháp 1. **Chờ và thử lại** * Chờ 30–60 giây trước khi thử lại * Lỗi này thường được giải quyết khi tải được cân bằng 2. **Triển khai cơ chế thử lại thông minh** * Sử dụng chiến lược thời gian chờ tăng theo cấp số nhân (bắt đầu với 1 giây, sau đó là 2 giây, 4 giây, v.v.) * Đặt giới hạn thử lại tối đa (3–5 lần) * Thêm độ trễ ngẫu nhiên để tránh hiệu ứng đám đông dồn dập 3. **Kiểm tra hoạt động bảo trì** * Xem [Trang trạng thái Helius](https://helius.statuspage.io/) để biết lịch bảo trì * Lập kế hoạch phù hợp với các khoảng thời gian bảo trì đã thông báo 4. **Phân phối tải** * Nếu có thể, hãy phân bổ các yêu cầu theo thời gian * Tránh các mẫu lưu lượng tăng đột biến có thể kích hoạt cơ chế bảo vệ quá tải Lỗi 503 được thiết kế để chỉ tồn tại tạm thời — dịch vụ sẽ tự động khôi phục khi tải máy chủ giảm. ## Ý nghĩa của lỗi này **504 Gateway Timeout** - Máy chủ không nhận được phản hồi từ các dịch vụ thượng nguồn trong khoảng thời gian chờ. ## Nguyên nhân phổ biến * Sự cố kết nối mạng * Các thao tác phức tạp vượt quá giới hạn thời gian chờ * Blockchain phản hồi chậm khi mạng bị tắc nghẽn nghiêm trọng * Yêu cầu lượng dữ liệu lớn mất quá nhiều thời gian để xử lý ## Giải pháp 1. **Kiểm tra kết nối** * Xác minh rằng kết nối internet ổn định * Thử nghiệm bằng một yêu cầu đơn giản để loại trừ sự cố cục bộ 2. **Tối ưu hóa các yêu cầu lớn** * Chia các yêu cầu hàng loạt lớn thành những phần nhỏ hơn * Sử dụng phân trang cho các truy vấn có lượng dữ liệu lớn * Cân nhắc sử dụng kết nối WebSocket cho dữ liệu thời gian thực 3. **Triển khai thời gian chờ** * Đặt giá trị thời gian chờ phù hợp trong mã máy khách (30–60 giây) * Xử lý lỗi hết thời gian chờ hợp lý bằng cách thử lại 4. **Theo dõi trạng thái dịch vụ** * Kiểm tra [Trang trạng thái Helius](https://helius.statuspage.io/) để biết các sự cố mạng * Tìm các báo cáo về tình trạng tắc nghẽn blockchain nghiêm trọng Lỗi hết thời gian chờ của cổng kết nối thường cho thấy mạng bị tắc nghẽn hoặc thao tác quá phức tạp. Hãy cân nhắc chia các yêu cầu lớn thành những phần nhỏ hơn. ## Bạn cần thêm trợ giúp? Nhận trợ giúp từ đội ngũ của chúng tôi qua Discord, trò chuyện hoặc email. Kiểm tra thông tin theo thời gian thực về tính khả dụng và hiệu suất của dịch vụ.