API cho nhà phát triển
Khóa API, endpoint, giới hạn tần suất và webhook
9 bài viết
Tổng quan về API LinkHarbor
URL gốc, sandbox, phiên bản, định dạng dữ liệu, phân trang và xác thực: những điều cần biết trước lệnh gọi REST API LinkHarbor đầu tiên.
Khóa API và access token
Tạo khóa API trong bảng điều khiển, chọn phạm vi, đổi lấy token 15 phút, lưu trữ an toàn và thu hồi khi cần – từng bước một.
Phạm vi: mọi quyền API
Cả 15 phạm vi cho khóa API và kết nối AI: mỗi phạm vi cho phép gì, tên của nó trong bảng điều khiển và những gì không khóa API nào làm được.
Các endpoint API theo khu vực
Mọi endpoint bạn dùng được với khóa API – sắp xếp theo khu vực, kèm phương thức, đường dẫn, phạm vi cần thiết và chức năng.
Giới hạn tần suất: mọi giới hạn và header
API LinkHarbor cho phép bao nhiêu yêu cầu mỗi phút, một yêu cầu lớn tối đa bao nhiêu, cách đọc các header và cách xử lý 429 đúng cách.
Định dạng lỗi API và mã lỗi
Phản hồi lỗi của API LinkHarbor có cấu trúc thế nào, các mã lỗi quan trọng nhất có nghĩa gì và mã của bạn nên phản ứng ra sao.
Webhook: sự kiện, payload và chữ ký
Thiết lập webhook trong bảng điều khiển, nhận lượt gửi và xác minh chữ ký HMAC – kèm ví dụ cho curl, Node.js và PHP.
Gửi doanh số và dữ liệu tùy chỉnh đến LinkHarbor
Dùng sale callback để gán doanh số từ cửa hàng cho lượt nhấp liên kết, và “Custom (API)” để gửi dữ liệu trực tiếp từ công cụ của bạn lên trang.
Từng bước: cập nhật trang qua API
Từ khóa API đến phiên bản đã xuất bản: thêm liên kết, đưa lên đầu, đổi thiết kế, kiểm tra bản nháp và xuất bản – với curl và jq.