Đăng bài & kết nối·4 phút đọc
Đăng bài lên website tự xây (API tuỳ chỉnh)
Website có trang quản trị riêng nhận bài qua một địa chỉ API do lập trình viên tạo — không cần WordPress.
Dùng khi website của bạn không chạy WordPress, Shopify, Haravan, Sapo, Ghost, Webflow hay Hashnode mà là website tự xây (Next.js, Laravel, PHP, Python…).
Cách hoạt động
- Lập trình viên tạo một địa chỉ nhận bài (POST, HTTPS), ví dụ
https://website-cua-ban.com/api/blog/receive. - Mỗi khi bạn duyệt bài (hoặc Autopilot đăng), hệ thống gửi bài tới địa chỉ đó: tiêu đề, slug, nội dung HTML và Markdown, mô tả, FAQ, ảnh bìa, danh sách ảnh, danh mục, trạng thái.
- Website lưu bài và trả về
idvàurlcủa bài — có url thì hệ thống mới yêu cầu Google lập chỉ mục và tự chia sẻ lên mạng xã hội.
Kết nối
- Vào Cài đặt website › Kết nối › API tuỳ chỉnh › Thêm.
- Dán địa chỉ nhận bài. Ở ô Mã bí mật, bấm Tạo mã rồi copy mã này vào cấu hình website của bạn (mã chỉ hiện một lần).
- Nhập danh mục nếu website cần (mặc định
tin-tuc). - Bấm Kiểm tra & lưu — hệ thống gửi một yêu cầu thử với
"event": "ping", website nên trả 200 mà không lưu bài.
Cho lập trình viên
Tài liệu đầy đủ, cách xác thực chữ ký (X-Signature, HMAC-SHA256) và code mẫu Next.js, Express, Laravel, FastAPI ở trang Tài liệu API.
Lỗi thường gặp
- 401 — mã bí mật trên website khác với mã đã lưu.
- 405 — địa chỉ chưa nhận phương thức POST.
- "Địa chỉ trả về một trang web chứ không phải API" — sai địa chỉ hoặc bị chuyển tới trang đăng nhập/404.
- Bài đã gửi nhưng không hiện — website chỉ coi
"published"là công khai; hệ thống gửi"publish", hãy chấp nhận cả hai.