Thêm website - API
Hướng dẫn thêm website đạng tự code thông qua lập trình API
Last updated
Hướng dẫn thêm website đạng tự code thông qua lập trình API
Last updated
Hướng dẫn này dùng cho các website không thuộc nền tảng tích hợp bởi AIKTP, bạn muốn kết nối vào AIKTP để sử dụng AI và đăng bài.
Để sử dụng tính năng này bạn cần lập trình 1 endpoint trên website của bạn. AIKTP sẽ thông qua Endpoint này để giao tiếp với website bạn.
Bạn tải source code mẫu tại https://aiktp.com/files/aiktp_api_php.zip
Quy trình là, bạn sửa lại code mẫu và upload ngược lên server của bạn. Đảm bảo các method trên server của bạn giống với method trong source code mẫu.
Bạn có thể kiểm tra các method tại link postman
Chú ý endpoin (URL) phải cố định không thay đổi. Vì thế các method giao tiếp giữa AIKTP và bạn đều thông qua phương thức POST.
Khi AIKTP giao tiếp với bạn, AIKTP sẽ giao tiếp thông qua 1 API Key. Bạn sẽ là người quản lý API key này.
Để hiệu chỉnh API key, bạn mở file aiktp_remote_api.php trong file zip bạn tải về.
Tìm dòng đầu tiên và sửa apiKey theo ý bạn
Sau khi sửa xong thì API này chính là thông số bạn dán vào trang https://aiktp.com/websites
Khi bạn dán API URL và API Key vào website aiktp.com, bấm Verify, hệ thống sẽ kết nối với bạn qua task "verifyAPIKey" và truyền đi theo phương thức _POST.
Nếu bạn trả về success, hệ thống sẽ coi như xác minh thành công. Và có thể kết nối với bạn.
Sau khi bạn xác minh website, bạn có thể tiến hành đăng bài. Quá trình đăng bài sẽ gồm 2 phần
Trước khi đăng bài: Hệ thống sẽ kết nối với bạn để lấy các chuyên mục thông qua task "getListCategories"
Sau khi bạn bấm nút "Publish Now" hệ thống sẽ kết nối với bạn thông qua task "createPost" hoặc "updatePost" tùy vào bài viết đó có currentPostId chưa.
currentPostId là giá trị bạn trả về khi thực hiện task "createPost".
Trong trường hợp bạn bấm 2,3 lần nút "Publish Now" mà không reload lại trang, hệ thống sẽ không có giá trị currentPostId vì thế sẽ tạo ra 2,3 bài giống nhau. Bạn phải tự kiểm soát trường hợp này.
Trong trường hợp bạn đăng bài lên website A, lại đăng tiếp vào website B, hệ thống sẽ truyền kèm currentPostId và gọi phương thức "updatePost", bạn cũng cần kiểm tra bài trước khi update bên phía bạn
Trong trường hợp bạn cần trợ giúp, vui lòng liên hệ với tele https://t.me/aiktpgroup
