Dưới đây là hướng dẫn chi tiết về cách sử dụng API viết bài từ URL Website với phương thức POST
và yêu cầu gửi kèm X-API-KEY
trong header.
Contents
Endpoint API:
POST https://api.laho.vn/api/writing-url
Headers:
{
"X-API-KEY": "your_api_key", // Thay "your_api_key" bằng API key thực tế
"Content-Type": "application/json"
}
Body (Yêu cầu):
Yêu cầu được gửi dưới dạng JSON với hai trường chính:
- url: Đường dẫn URL của bài viết bạn muốn lấy nội dung và viết lại.
- focus_keywords: Các từ khóa trọng tâm cần được nhấn mạnh khi viết lại bài viết.
Ví dụ về request body:
{
"contents": "https://example.com/sample-article",
"language": "vi_VN"
}
Ví dụ gửi yêu cầu API bằng cURL:
Dưới đây là ví dụ về cách sử dụng API này thông qua cURL
:
Ví dụ gửi yêu cầu API bằng JavaScript (Fetch):
Bạn cũng có thể sử dụng JavaScript để gọi API:
Ví dụ gửi yêu cầu API bằng Axios:
Axios cũng là một cách khác để gọi API trong ứng dụng Node.js hoặc Frontend:
Phản hồi từ API khi thành công:
Khi gọi API thành công, bạn sẽ nhận được một phản hồi JSON với hai trường chính:
- rewritten_article: Bài viết đã được viết lại, tập trung vào các từ khóa mà bạn cung cấp.
- remaining_words: Số ký tự còn lại của bạn sau khi API trừ đi số ký tự đã sử dụng.
Lưu ý: Kết quả trả về từ API sẽ ở dạng Markdown. Điều này cho phép bài viết được định dạng dễ dàng khi hiển thị trên các nền tảng hỗ trợ Markdown.
Tìm hiểu: Markdown là gì?
Ví dụ phản hồi:
{
"generated_content": "Nội dung bài viết trả về",
"og_image": url ảnh,
"remaining_words": Ký tự còn lại
}
Phản hồi khi có lỗi:
- 400 Bad Request: Nếu không có URL hoặc bạn đã hết số ký tự.
- 500 Internal Server Error: Nếu có vấn đề trong quá trình xử lý hoặc khi gọi API.
Ví dụ phản hồi khi lỗi:
{
"error": "URL là bắt buộc"
}
Hoặc:
{
"error": "Bạn đã hết ký tự, vui lòng nâng cấp gói."
}