VI | EN
Nhắn Messenger
Dành cho developer

Tạo bài viết (type=normal) hoặc bài video (type=video) — API Zalo OA

Tạo bài viết · gọi qua Quantri360 bằng một API key cho chính tài khoản / tài sản bạn đã kết nối và ủy quyền — 360 lo việc ký request và làm mới phiên đăng nhập bạn đã cấp.

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ênVị tríKiểuMẫuMô tả
AuthorizationheaderheaderBearer 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_idquerystring1173478676788457425OA_ID của Zalo OA brand đã nối (GET /v1/platforms). Mỗi brand một OA — có thể bỏ.
dataquerystring (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ênVị tríKiểuBắt buộcMẫuMô tả
typebodyStringCóNhận giá trị là “normal”
titlebodyStringCóTiêu đề bài viết. Tối đa 150 ký tự.
authorbodyStringCóTác giả bài viết. Tối đa 50 ký tự.
coverbodyJSON objectCó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.
descriptionbodyStringCóMô tả về bài viết. Tối đa 300 ký tự.
bodybodyJSON ArrayCó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_mediasbodyJSON ArrayCó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_linkbodyStringCóĐường dẫn sử dụng để track lượng người xem của bài viết.
statusbodyStringCó(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”.
commentbodyStringCó(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ênKiểuMẫuMô tả
errorint0 = thành công; khác 0 xem `message` (Zalo trả HTTP 200 kèm mã lỗi).
messagestringThông điệp của Zalo.
dataobject
tokenstring9xk090B1ANibkhyg9ke8SZgMg39Pz7bNJvJvKrpA821_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

  1. Đăng ký tài khoản Partner
  2. Mở loại dữ liệu thuộc nhóm Nội dung (bài viết) ở trang nền tảng
  3. Tạo API key (tick kênh Zalo OA)
  4. Gọi theo ví dụ ở trên