Lợi ích khi kết nối
Kết nối khóa Ahrefs của riêng quý vị đồng nghĩa với việc dữ liệu SEO chúng tôi thu thập cho các trang web của quý vị sẽ được thu thập bằng tài khoản Ahrefs của quý vị thay vì của chúng tôi. Quý vị sẽ thấy cùng các chỉ số đó trong bảng điều khiển của mình, được trích xuất từ gói đăng ký của chính quý vị.
Trước khi bắt đầu
Một gói Ahrefs có bao gồm quyền truy cập API, cùng quyền chủ sở hữu hoặc quản trị viên trên không gian làm việc Ahrefs — chỉ họ mới có thể tạo khóa API.
1. Tạo khóa tại Ahrefs
Trong Ahrefs, hãy mở Account settings → API keys và tạo một khóa. Mỗi khóa có thời hạn một năm và sau đó sẽ ngừng hoạt động; trang này sẽ hiển thị ngày hết hạn của từng khóa. Quý vị cũng có thể giới hạn số đơn vị API mà một khóa được phép sử dụng mỗi tháng trên cùng trang này.
2. Kết nối tại đây
Mở Integrations trong bảng điều khiển của quý vị và chọn Connect an account. Chọn Your own SEO data làm nhóm và Ahrefs làm tài khoản, điền API key, rồi nhấn Connect account.
Chúng tôi sẽ kiểm tra nội dung quý vị dán trước khi lưu bất kỳ thông tin nào. Khóa không hoạt động sẽ không bao giờ được lưu trữ, và thông báo phản hồi sẽ cho biết khóa gặp vấn đề gì. Khóa hoạt động được sẽ được lưu trữ mã hóa trong kho bí mật của chúng tôi — không bao giờ lưu trong cơ sở dữ liệu — và sẽ không bao giờ hiển thị lại, kể cả với quý vị.
Điều gì sẽ diễn ra tiếp theo
- Các lượt kiểm tra độ uy tín và backlink mà chúng tôi thực hiện cho các trang web của quý vị sẽ sử dụng khóa của quý vị, tính vào hạn ngạch gói của quý vị và ngừng sử dụng khóa của chúng tôi. Chúng tôi không tính phí quý vị cho các lượt kiểm tra chạy bằng khóa của quý vị.
- Nếu khóa của quý vị bị thu hồi hoặc hết hạn ngạch, chúng tôi sẽ dừng lại và hiển thị cho quý vị — trên các màn hình nơi xuất hiện chỉ số — thay vì âm thầm chuyển về tài khoản của chúng tôi. Hãy sửa khóa tại nhà cung cấp, hoặc ngắt kết nối để quay lại những gì gói của quý vị bao gồm.
- Các lượt kiểm tra sẽ chạy theo lịch trình thông thường; việc kết nối khóa không kích hoạt việc gọi API ồ ạt làm ảnh hưởng đến hạn ngạch của quý vị.
Nếu không kết nối được
Khóa ngừng hoạt động sau một năm. Khóa Ahrefs hết hạn sau mười hai tháng. Hãy tạo một khóa mới và kết nối lại.
Các lượt kiểm tra dừng lại kèm thông báo giới hạn. Đã dùng hết hạn mức đơn vị API hằng tháng của khóa, hoặc hạn mức trong gói của quý vị. Hãy tăng giới hạn trong Account settings → API keys, hoặc đợi đến kỳ gia hạn.
Hệ thống báo khóa bị từ chối. Hầu như luôn là một trong ba nguyên nhân: khoảng trắng hoặc dấu xuống dòng được sao chép kèm, khóa đã hết hạn, hoặc khóa đã bị thu hồi hoặc tạo lại sau khi quý vị sao chép. Hãy tạo một khóa mới và dán lại.
Kết nối được nhưng sau đó phát sinh lỗi. Khóa xác thực thành công nhưng thiếu quyền mà tác vụ yêu cầu. Hãy tạo khóa mới với các quyền được liệt kê ở trên, sau đó ngắt kết nối cũ và kết nối khóa mới.
Ngắt kết nối
Mở Integrations, tìm tài khoản và nhấn Disconnect. Thao tác này sẽ xóa khóa đã lưu trữ ngay lập tức. Bất kỳ tác vụ nào đang sử dụng khóa sẽ dừng lại ở hành động tiếp theo, và các màn hình phụ thuộc vào khóa sẽ thông báo rõ ràng thay vì âm thầm gặp lỗi.
Việc ngắt kết nối không hoàn tác những gì đã được thực hiện — các bản ghi, hoạt động triển khai hoặc cài đặt chúng tôi đã thay đổi trên tài khoản của quý vị vẫn sẽ giữ nguyên. Nếu quý vị cho rằng chính khóa đó có thể đã bị lộ, hãy thu hồi cả khóa tại nhà cung cấp; việc ngắt kết nối chỉ xóa bản sao của chúng tôi, không phải của họ.