Tạo tin tức
API hỗ trợ tiếp nhận và tạo mới bài viết tin tức từ nguồn dữ liệu đối tác, bao gồm nội dung, thông tin nguồn, các mã cổ phiếu liên quan, chuyên mục và dữ liệu phân tích đi kèm. Dữ liệu sau khi tạo được sử dụng để hiển thị trên các kênh tin tức của hệ thống.
HTTP request
- URL:
/api/company/v1/partner/news/create - Method:
POST - Content Type: None
- Response Type: application/json
Tham số header
| Header | Mô tả | Kiểu dữ liệu | Bắt buộc |
|---|---|---|---|
| X-Api-Key | Khóa duy nhất. | string | có |
Yêu Cầu (Request)
Request Mẫu
{
"title": "Không lâu sau khi được bổ nhiệm, TGĐ Chứng khoán LPBank bất ngờ rút khỏi vị trí",
"content": "<div><p>Tập đoàn Hoàng Anh Gia Lai (HAGL, mã chứng khoán: HAG) vừa công bố...</p></div>",
"summary": "Tóm tắt nội dung bài viết.",
"thumbUrl": "https://cdn.simplize.vn/simplizevn/news/2024/01/18/thumb.jpg",
"tickers": [
"HAG",
"LPB"
],
"ticker": "HAG",
"orgPublishTime": "2024-01-17T04:11:01Z",
"sourceUrl": "https://markettimes.vn/khong-lau-sau-khi-duoc-bo-nhiem-tgd-chung-khoan",
"sourceWebsiteUrl": "https://markettimes.vn",
"sourceSiteName": "Báo Markettimes",
"sourceNameDisplay": "Markettimes",
"author": "Trọng Hiếu",
"categoryCode": "",
"category": "chung_khoan",
"categories": [
"chung-khoan",
"tai-chinh"
]
}
Chi Tiết Tham Số Request Body
| Tên Thuộc Tính | Kiểu Dữ Liệu | Bắt buộc | Mô Tả |
|---|---|---|---|
| title | string | có | Tiêu đề tin tức. |
| sourceUrl | string | có | Đường dẫn bài viết gốc. |
| content | string | không | Nội dung HTML của tin. |
| summary | string | không | Tóm tắt nội dung. |
| thumbUrl | string | không | Đường dẫn ảnh đại diện. |
| tickers | array of string | không | Danh sách mã cổ phiếu liên quan. |
| ticker | string | không | Mã cổ phiếu chính. |
| orgPublishTime | string | không | Thời điểm xuất bản gốc (Định dạng: yyyy-MM-dd'T'HH:mm:ss.SSS'Z'). |
| sourceWebsiteUrl | string | không | Đường dẫn website nguồn. |
| sourceSiteName | string | không | Tên nguồn tin. |
| sourceNameDisplay | string | không | Tên nguồn tin hiển thị. |
| author | string | không | Tác giả. |
| categoryCode | string | không | Mã chuyên mục. |
| category | string | không | Chuyên mục chính. |
| categories | array of string | không | Danh sách chuyên mục. |
Phản Hồi (Response)
Response Mẫu
{
"status": 200,
"message": "Success",
"data": {
"code": "3a736276-04a2-443f-9c1e-8b1dad497635",
"title": "Không lâu sau khi được bổ nhiệm, TGĐ Chứng khoán LPBank bất ngờ rút khỏi vị trí",
"content": "<div><p>Tập đoàn Hoàng Anh Gia Lai (HAGL, mã chứng khoán: HAG) vừa công bố...</p></div>",
"summary": "Tóm tắt nội dung bài viết.",
"thumbUrl": "https://cdn.simplize.vn/simplizevn/news/2024/01/18/thumb.jpg",
"tickers": [
"HAG",
"LPB"
],
"ticker": "HAG",
"orgPublishTime": "2024-01-17T04:11:01Z",
"sourceUrl": "https://markettimes.vn/khong-lau-sau-khi-duoc-bo-nhiem-tgd-chung-khoan",
"sourceWebsiteUrl": "https://markettimes.vn",
"sourceSiteName": "Báo Markettimes",
"sourceNameDisplay": "Markettimes",
"author": "Trọng Hiếu",
"status": 1,
"type": "news",
"createdDate": "2024-01-18T05:15:01.282Z",
"categoryCode": "",
"category": "chung_khoan",
"categories": [
"chung-khoan",
"tai-chinh"
],
"ts": 1705554901000
}
}
Chi Tiết Tham Số Response
| Tên Thuộc Tính | Kiểu Dữ Liệu | Mô Tả |
|---|---|---|
| status | number | Mã trạng thái HTTP. |
| message | string | Thông báo kết quả xử lý. |
| data | object (Xem chi tiết) | Thông tin tin tức vừa tạo. |
| Tên Thuộc Tính | Kiểu Dữ Liệu | Mô Tả |
|---|---|---|
| code | string | Mã định danh duy nhất của tin (hệ thống tự sinh, dạng UUID). |
| title | string | Tiêu đề tin tức. |
| content | string | Nội dung HTML của tin. |
| summary | string | Tóm tắt nội dung. |
| thumbUrl | string | Đường dẫn ảnh đại diện. |
| tickers | array of string | Danh sách mã cổ phiếu liên quan. |
| ticker | string | Mã cổ phiếu chính. |
| orgPublishTime | string | Thời điểm xuất bản gốc (Định dạng: yyyy-MM-dd'T'HH:mm:ss.SSS'Z'). |
| sourceUrl | string | Đường dẫn bài viết gốc. |
| sourceWebsiteUrl | string | Đường dẫn website nguồn. |
| sourceSiteName | string | Tên nguồn tin. |
| sourceNameDisplay | string | Tên nguồn tin hiển thị. |
| author | string | Tác giả. |
| status | number | Trạng thái tin (mặc định: 1). |
| type | string | Loại tin (mặc định: news). |
| createdDate | string | Thời điểm tạo bản ghi (Định dạng: yyyy-MM-dd'T'HH:mm:ss.SSS'Z'). |
| categoryCode | string | Mã chuyên mục. |
| category | string | Chuyên mục chính. |
| categories | array of string | Danh sách chuyên mục. |
| ts | number | Dấu thời gian (epoch millis). |