Check my backlink trả về kết quả trống: bảng lỗi

Quy tắc bao phủ hầu hết các trường hợp

Thử lại các lỗi mạng. Không bao giờ thử lại 401 hoặc 402. Loại đầu tự khắc phục sau vài giây; loại thứ hai cần sự can thiệp của con người, và việc gửi lại liên tục chỉ làm đầy nhật ký của bạn.

Mỗi phản hồi JSON đều có trường ok, và các phản hồi xác thực thêm _credits với chi phí gọi và số dư còn lại. Hãy kiểm tra ok trong thân phản hồi ngay cả khi trạng thái HTTP có vẻ ổn.

Các khoảng thời gian thử lại dưới đây là lời khuyên từ đội kỹ thuật của chúng tôi, không phải giới hạn được ghi trong tài liệu. Tài liệu API mà chúng tôi nắm giữ không công bố giới hạn tốc độ, vì vậy hãy tự đặt giới hạn trên của riêng bạn và giữ nó ở mức vừa phải.

Tại sao không thử lại 401 và 402

401 là vấn đề về khóa, còn 402 là vấn đề về số dư. Không có trường hợp nào tự hết sau hai lần thử cách nhau một giây, nên việc thử lại chỉ thêm nhiễu vào nhật ký của bạn mà không mang lại lợi ích gì.

Việc chờ đợi cũng không khắc phục được 402. Số dư sẽ giữ nguyên cho đến khi ai đó nạp tiền từ trang tài khoản, vì vậy phản ứng hữu ích nhất là một thông báo rõ ràng và cảnh báo cho người chịu trách nhiệm về ngân sách.

401 cần được xem xét lại tiêu đề hoặc tham số khóa, và kiểm tra xem khóa có bị thay thế hay không. Thử lại cùng một khóa sai nhiều lần không chứng minh được điều gì.

Một khóa sai và một số dư trống cũng hiển thị khác nhau trên bảng điều khiển của bạn. Hãy đặt chúng vào các cảnh báo riêng biệt, để người nạp tiền không bị đánh thức vì một lỗi gõ phím, và người thay khóa không bị gọi khi chỉ là vấn đề về số dư.

Lỗi mạng và cơ chế giảm tần suất

Thời gian chờ hoặc kết nối bị ngắt có thể tự khắc phục, vì vậy đó là những trường hợp đáng để thử lại. Chờ 1, 2, 4 và sau đó là 8 giây, thêm một chút độ rung (jitter), và dừng lại sau lần thử thứ tư.

Các khoảng thời gian này là lời khuyên của chúng tôi, không phải giới hạn được ghi trong tài liệu. Hãy tự đặt giới hạn trên của riêng bạn, ghi lại mọi lần thử lại và cảnh báo khi số lần thử tăng lên, vì tỷ lệ thử lại tăng thường là dấu hiệu đầu tiên của sự cố từ phía máy chủ.

Hãy giữ thời gian chờ trên phía của bạn rõ ràng, dưới dạng một hằng số có tên. Giá trị mặc định ẩn thay đổi khi nâng cấp thư viện là nguyên nhân phổ biến khiến một công việc chạy ban đêm bắt đầu lỗi chỉ trên một máy chủ.

Hãy theo dõi thời gian phản hồi từ máy chủ cũng như tỷ lệ lỗi. Một phản hồi chậm nhưng không bao giờ lỗi vẫn có thể chiếm dụng worker của bạn, và vòng lặp thử lại sẽ làm tình trạng chậm này tồi tệ hơn.

Chuẩn hóa tên miền trước khi gọi

Hầu hết các lệnh gọi thất bại bắt đầu từ hộp đầu vào, không phải từ mạng. Người dùng dán bất cứ thứ gì họ đã sao chép, và mã của bạn phải chuyển đổi đó thành một tên miền thuần túy trước khi API nhận được nó.

Loại bỏ lược đồ và đường dẫn

Loại bỏ lược đồ, bất kỳ đường dẫn nào và chuỗi truy vấn. Một địa chỉ bài báo được dán vào sẽ trở thành máy chủ của nó, và chỉ máy chủ mới được gửi lên máy chủ.

Chuyển đổi máy chủ thành chữ thường. Giữ việc làm sạch trong một hàm, để cùng một quy tắc chạy trong biểu mẫu, trong công việc hàng loạt và trong các bài kiểm tra.

Kiểm tra việc làm sạch với năm hoặc sáu đầu vào thực tế được dán vào, bao gồm một cái có dấu gạch chéo cuối và một cái có chuỗi truy vấn. Những trường hợp này làm lộ ra các lỗi mà một ví dụ sạch sẽ không bao giờ hiển thị.

Quyết định một lần cách xử lý www.

Chọn một quy tắc cho www. và áp dụng nó trong một hàm duy nhất, để cùng một trang web không bao giờ được tra cứu dưới hai cách viết.

Viết quy tắc xuống bên cạnh hàm. Nhà phát triển tiếp theo gặp phải www thừa sẽ tìm thấy quyết định đó, chứ không phải một ý kiến thứ hai.

Bất kể quy tắc nào bạn chọn, hãy giữ nó trong một tệp và viết một bài kiểm tra cho nó. Bài kiểm tra là bản ghi của quyết định, và nó ngắn gọn.

Từ chối những gì không thể là tên miền

Từ chối đầu vào có khoảng trắng hoặc nhãn trống, và hiển thị một thông báo ngắn trong biểu mẫu. Một chuỗi bị từ chối không tốn gì, trong khi một chuỗi xấu sẽ gây ra một lệnh gọi thất bại và một người dùng bối rối.

Dấu chấm cuối là trường hợp kỳ lạ. Loại bỏ một dấu chấm ở cuối máy chủ và coi bất kỳ thứ gì khác là không hợp lệ.

Hiển thị việc từ chối bên cạnh trường, không phải dưới dạng thông báo biến mất. Một người dùng có thể thấy lỗi sẽ khắc phục nó trong một lần thử.

Kết quả trống và tuổi của chỉ mục

Khi ai đó nhập "check my backlink" vào biểu mẫu của bạn và nhận được kết quả trống, một câu trả lời trống không phải lúc nào cũng là lỗi. Nó thường có nghĩa là tên miền mới, quá nhỏ hoặc đơn giản là chưa được lập chỉ mục, và màn hình nên nói rõ điều đó.

Một trang web mới hoàn toàn

Một trang web được ra mắt vào tuần trước có thể không có tên miền trỏ đến trong chỉ mục. Hiển thị "chưa được lập chỉ mục" cùng với ngày lập chỉ mục, và cung cấp lệnh gọi overview miễn phí để kiểm tra chéo.

Không lưu trữ kết quả trống đó trong thời gian dài. Vài giờ là đủ, và lần xây dựng lại tiếp theo có thể đưa trang web vào chỉ mục.

Hãy cho người biết khi chỉ mục được xây dựng lại lần cuối, bằng lời lẽ đơn giản. Một ngày bên cạnh một kết quả trống giải thích khoảng trống tốt hơn một thông báo dài hơn.

Một ghi chú ngắn trong giao diện người dùng của riêng bạn là đủ ở đây. Không ai mong đợi một chỉ mục trực tiếp, và một câu văn đơn giản bên cạnh ngày lập chỉ mục đọc như sự trung thực.

Một con số không khớp với công cụ khác

Các trình thu thập dữ liệu khác nhau thấy các phần khác nhau của web. Hãy đọc số DR như một vị trí trong một công cụ cụ thể, và hướng người đọc đến Tham chiếu DR để biết công thức.

Một ghi chú ngắn dưới con số đó sẽ tiết kiệm thời gian hỗ trợ hơn bất kỳ lời xin lỗi nào sau đó.

Nếu hai lần đọc khác nhau, hãy so sánh số lượng tên miền trỏ đến trước tiên. Công thức DR đơn giản, vì vậy hầu hết các bất đồng đều quy về số lượng.

Các dòng dừng ở 50.000

Khi một danh sách dừng ở giới hạn, câu trả lời là chính xác cho những gì API cho phép. Hãy dán nhãn điểm cắt và liên kết đến Ghi chú về phân trang thay vì cố gắng truy cập một trang sâu hơn.

Các trang sâu hơn qua điểm đó không phải là một lần thử lại. Đó là một truy vấn khác, và việc coi chúng là một là cách một vòng lặp chạy trong nhiều giờ.

Hãy giữ điểm cắt hiển thị trong bản xuất, để một bảng tính mở ra một tháng sau vẫn hiển thị rằng danh sách đã bị giới hạn.

Hiển thị số hàng bên cạnh bảng biến điểm cắt thành một sự thật có thể nhìn thấy. Một người đọc thấy 50.000 hàng sẽ biết cách đặt câu hỏi hẹp hơn.