Tạo công cụ tự động hóa xây dựng liên kết với BlogDrip API

Các tài khoản nhà quảng cáo muốn kết nối phần mềm của họ — bảng điều khiển tùy chỉnh, nền tảng agency SEO, CRM nội bộ — với quy trình đặt bài viết khách của BlogDrip. Người dùng điển hình là các agency quản lý chiến dịch ở quy mô lớn, đội SEO nội bộ tích hợp với hệ thống hiện có, và các nhà phát triển xây dựng công cụ vận hành cho một khách hàng hoặc sản phẩm cụ thể.

Để xây dựng tích hợp thì có. API là giao diện lập trình — sử dụng nó đòi hỏi viết mã hoặc làm việc với một nhà phát triển. Nếu bạn muốn lợi ích vận hành mà không làm tích hợp, giao diện trên thị trường (marketplace) cung cấp cùng chức năng đặt hàng theo cách thủ công.

Một tài khoản BlogDrip hoạt động và có chi tiêu ít nhất €500 mỗi tháng tổng cộng — đơn thủ công và đơn API đều được tính vào ngưỡng. Quyền truy cập API sẽ tự động bị vô hiệu hóa nếu tài khoản chi dưới mức tối thiểu trong một tháng. €500 là ngưỡng khối lượng chi tiêu, không phải phí đăng ký API riêng.

Tài liệu API chính thức được xuất bản tại app.blogdrip.com/api/public/docs/index.html, với đặc tả OpenAPI máy đọc được tại app.blogdrip.com/api/public/openapi.json. Cả hai mô tả sơ đồ xác thực, danh mục đầy đủ các endpoint dưới namespace `/api/public/*`, hình dạng yêu cầu và phản hồi, định dạng phân trang và các phản hồi lỗi. Hãy coi chúng là nguồn chính cho tích hợp của bạn.

Trong Cài đặt của tôi → Truy cập API tại app.blogdrip.com/settings. Bạn sẽ nhận được `x-client-id` và `x-client-secret`; cả hai được gửi trong mọi yêu cầu có xác thực như HTTP headers. Mật khẩu chỉ hiển thị một lần khi phát hành hoặc khi xoay vòng — sao chép vào secret manager ngay, vì không thể truy xuất lại sau này. Thông tin xác thực là theo tài khoản; đối xử chúng như bất kỳ bí mật nào khác và không lưu vào version control.

Các endpoint danh sách đóng gói phản hồi trong phong bì `{ data, pagination }` và sử dụng phân trang bắt đầu từ 0 — gửi `?page=0` cho trang đầu, `?page=1` cho trang thứ hai, v.v. Khối pagination trong phản hồi cho bạn biết còn trang tiếp theo hay không. Nếu bạn di chuyển từ giao diện cũ `/api/<path>`, hình dạng phản hồi không thay đổi — chỉ có base path di chuyển sang `/api/public/*`.

Kiểm tra đặc tả OpenAPI tại app.blogdrip.com/api/public/openapi.json để biết danh sách hiện tại các cơ chế callback hoặc thông báo sự kiện được hỗ trợ. Nếu một tính năng không được liệt kê, hãy xây dựng tích hợp mà không giả định nó tồn tại — polling API theo lịch của bạn là phương án an toàn thay thế.

Câu trả lời chính xác nằm trong tài liệu API hiện tại. Nếu có sandbox được liệt kê, hãy dùng nó cho kiểm thử tích hợp. Nếu không có, đừng tạo đơn trả phí thực sự trong quá trình kiểm thử tự động mà không có ủy quyền rõ ràng — dùng chiến dịch thử chuyên dụng và kiểm duyệt có con người thay thế.

Khả năng xuất bản tức thì phụ thuộc vào website được chọn có tích hợp xuất bản tự động được hỗ trợ hay không (hoặc plugin WordPress của BlogDrip hoặc kết nối API dành cho Agency). Mọi đơn — API hay thủ công — đặt trên một website đủ điều kiện đều có thể hưởng lợi từ xuất bản tự động. Không phải website nào trong thị trường cũng hỗ trợ, nên tích hợp của bạn nên coi thời điểm xuất bản là theo từng website, không đồng đều.

Advertiser API dành cho khách hàng muốn tự động hóa đặt bài viết khách từ phần mềm của họ. Agency API dành cho các agency bên ngoài, nền tảng xây dựng liên kết và mạng lưới nhà xuất bản muốn kết nối kho nội dung của họ với BlogDrip và tự động hóa các quy trình hoàn tất được hỗ trợ. Cả hai hoạt động độc lập — dùng cái này không yêu cầu phải dùng cái kia.

Nếu bạn không nhận được phản hồi xác nhận, hãy giả định yêu cầu đầu tiên có thể đã thành công ở phía server. Không tự động thử lại các yêu cầu tạo đơn không idempotent. Thêm khóa loại trùng phía máy chủ, hoặc truy vấn xem đơn có thể đã được tạo chưa trước khi thử lại — tùy theo quy trình của bạn. Thử lại trên một đơn đã thành công nhưng bạn không nhìn thấy phản hồi sẽ tạo ra phí trả kép.