Tạo bài viết
POST/v2.0/article/createGọi qua 360: POST https://partner.quantri360.com/v1/zalo/v2.0/article/create
Endpoint ghi — thay đổi dữ liệu trên Zalo OA. Key phải được tạo với tick "Cho phép gọi API ghi", nếu không sẽ nhận 403 write_not_allowed. Mỗi lần gọi được ghi nhật ký.
Mô tả API
Tạo bài viết nhanh trên OA. Ảnh dùng cho API Article không được vượt quá 1MB. Sau khi tạo thành công, response trả về token; gọi API lấy id bài viết để kiểm tra kết quả tiến trình.
- Cùng endpoint còn dùng cho: Nội dung dạng Video — khác ở cấu trúc body (xem tài liệu Zalo từng loại).
Request
Địa chỉ
POST https://partner.quantri360.com/v1/zalo/v2.0/article/create
Xác thực & gian hàng
| Tên | Vị trí | Kiểu | Mẫu | Mô tả |
|---|---|---|---|---|
| Authorization | header | header | Bearer q360_live_ab12cd34_… | Khóa API của brand (tạo ở mục API key). Bắt buộc với mọi request. Brand suy từ key — không truyền mã brand. |
| platform_shop_id | query | string | 1173478676788457425 | OA_ID của Zalo OA brand đã nối (GET /v1/platforms). Mỗi brand một OA — có thể bỏ. |
| data | query | string (JSON) | {"offset":0,"count":10} | Nhiều API GET của Zalo nhận tham số gói trong data là chuỗi JSON — gửi nguyên như tài liệu Zalo. |
Tham số request
| Tên | Vị trí | Kiểu | Bắt buộc | Mẫu | Mô tả |
|---|---|---|---|---|---|
| type | body | String | Có | Nhận giá trị là “normal” | |
| title | body | String | Có | Tiêu đề bài viết. Tối đa 150 ký tự. | |
| author | body | String | Có | Tác giả bài viết. Tối đa 50 ký tự. | |
| cover | body | JSON object | Có | Ví dụ: Khi "cover_type": "photo". Ví dụ: { "cover_type": "photo", "photo_url": "photo_url", "status": "hide" } Trong đó: · photo_url : Đường dẫn đến ảnh. · status : Nhận một trong 2 giá trị “show” hoặc “hide”. Dùng để thiết lập trạng thái ẩn hiện của cover khi hiển thị bài viết. Khi "cover_type": "video" . Ví dụ: { "cover_type": "video", "cover_view": "horizontal", "video_id": "video_id", "status": "show" } Trong đó: · cover_view : Nhận 3 giá trị “horizontal” (video ngang), “vertical”(video dọc), “square”(video vuông). · video_id : id của video được lấy từ api upload. · status : Nhận một trong 2 giá trị “show” hoặc “hide”. Dùng để thiết lập trạng thái ẩn hiện của cover khi hiển thị bài viết. | |
| description | body | String | Có | Mô tả về bài viết. Tối đa 300 ký tự. | |
| body | body | JSON Array | Có | Chứa nội dung chính của bài viết. Mỗi phần tử là một JsonObject. Mỗi đối tượng thể hiện một đoạn (paragraph) của bài viết. Đối tượng có các loại sau: Thuộc tính "type": "text" (nội dung là text): { "type": "text", "content": "content" } Thuộc tính "type": "image" (nội dung là hình ảnh): { "type": "image", "url": "url_photo", "caption": "thuoc tinh khong bat buoc" } Trong đó: url : đường dẫn đến hình ảnh. caption : Mô tả của hình. (Không bắt buộc). Thuộc tính "type": "video" (nội dung là video). Ví dụ: { "type": "video", "url": "url_video", "thumb": "url_anh" } { "type": "video", "video_id": "video_id", "thumb": "url_anh" } Trong đó: url : đường dẫn đến trang chứa video. video_id : id của video trả về từ api upload. thumb :Thumbnail của video. (Không bắt buộc). Thuộc tính "type": "product" (nội dung là sản phẩm của cửa hàng trên OA): { "type": "product", "id": "product_id" } Trong đó: · id : là id của sản phẩm trên cửa hàng của OA. | |
| related_medias | body | JSON Array | Có | Ví dụ: ["id_bai_viet_lien_quan_1", "id_bai_viet_lien_quan_2", ...] Chứa danh sách các id của bài viết liên quan đến bài viết chính. | |
| tracking_link | body | String | Có | Đường dẫn sử dụng để track lượng người xem của bài viết. | |
| status | body | String | Có | (Không bắt buộc, mặc định là “hide”) Gồm 2 giá trị: · “show”: Hiển thị bài viết này trên Official Account ngay sau khi được tạo. · “hide”: Tạm ẩn bài viết này để kiểm tra lại nội dung trước khi hiển thị bài viết này trên Official Account – có thể dùng trang admin Official Account hoặc API update để chuyển status thành “show”. | |
| comment | body | String | Có | (Không bắt buộc, mặc định là “show”) Gồm 2 giá trị: · “hide”: không cho phép comment trên bài viết này. · “show”: Cho phép comment trên bài viết này. |
Ví dụ request
curl -s -X POST "https://partner.quantri360.com/v1/zalo/v2.0/article/create" \
-H "Authorization: Bearer $KEY" \
-H "Content-Type: application/json" \
-d '{"type":"","title":"","author":"","cover":"","description":"","body":[{"type":"","title":"","description":"","video_id":"","avatar":"","status":"","comment":""}],"related_medias":[],"tracking_link":"","status":"","comment":""}'
Python
import requests
KEY = "q360_live_..." # khóa API của brand
r = requests.post(
"https://partner.quantri360.com/v1/zalo/v2.0/article/create",
params={},
json={
"type": "",
"title": "",
"author": "",
"cover": "",
"description": "",
"body": [
{
"type": "",
"title": "",
"description": "",
"video_id": "",
"avatar": "",
"status": "",
"comment": ""
}
],
"related_medias": [],
"tracking_link": "",
"status": "",
"comment": ""
},
headers={"Authorization": f"Bearer {KEY}"},
timeout=60,
)
print(r.status_code)
print(r.json())Node.js
const KEY = 'q360_live_...'; // khóa API của brand
const url = new URL('https://partner.quantri360.com/v1/zalo/v2.0/article/create');
for (const [k, v] of Object.entries({})) url.searchParams.set(k, typeof v === 'object' ? JSON.stringify(v) : String(v));
const r = await fetch(url, {
method: 'POST',
headers: { Authorization: `Bearer ${KEY}`, 'Content-Type': 'application/json' },
body: JSON.stringify({"type":"","title":"","author":"","cover":"","description":"","body":[{"type":"","title":"","description":"","video_id":"","avatar":"","status":"","comment":""}],"related_medias":[],"tracking_link":"","status":"","comment":""}),
});
console.log(r.status, await r.json());PHP
<?php
$key = 'q360_live_...'; // khóa API của brand
$url = 'https://partner.quantri360.com/v1/zalo/v2.0/article/create' . '?' . http_build_query([]);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $key, 'Content-Type: application/json']);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{"type":"","title":"","author":"","cover":"","description":"","body":[{"type":"","title":"","description":"","video_id":"","avatar":"","status":"","comment":""}],"related_medias":[],"tracking_link":"","status":"","comment":""}');
$res = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status, "\n", $res;Response
Tham số phản hồi (nguyên của Zalo OA)
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| error | int | 0 = thành công; khác 0 xem `message` (Zalo trả HTTP 200 kèm mã lỗi). | |
| message | string | Thông điệp của Zalo. | |
| data | object | ||
| token | string | 9xk090B1ANibkhyg9ke8SZgMg39Pz7bNJvJvKrpA821_XVbaI-Dr9ME5ma44nqGPOw3dKmR2SreHY_ya |
Mẫu phản hồi
{
"error": 0,
"message": "Success",
"data": {
"token": "9xk090B1ANibkhyg9ke8SZgMg39Pz7bNJvJvKrpA821_XVbaI-Dr9ME5ma44nqGPOw3dKmR2SreHY_yaUiOcMrkWX0XknWH0IOQtEY_N1r9Ahu8xJT9QEIU9paOpwc0QDhhqSmU3So8WmlqcEvDEKb_euG5CbKHp9kJS432-35aKsOzSQva30L2cabKwcZqJNwkvQ63M7Mf7bQml9SK5BZJyZ4O8jmT16OwbFNdmA4iIdQPETiq8EtUkhM0AYMCHDkNmJWs9CLPkgFuBJ9Gm536kw1DQb34I9xF_4qE2BX4fk_uJIOKl6ZIYuH9LdpaMPAxi5mILRn5XgxmNLi8v56VywqLGnJaGDJ4mKWZXC0_G15"
}
}
Bắt đầu dùng
- Đăng ký tài khoản Partner
- Mở loại dữ liệu thuộc nhóm Nội dung (bài viết) ở trang nền tảng
- Tạo API key (tick kênh Zalo OA)
- Gọi theo ví dụ ở trên