user/tasks
POST/extapi/v3/user/tasksGọi qua 360: POST https://partner.quantri360.com/v1/base_wework/extapi/v3/user/tasks
Sắp mở. API này đã chạy thật qua 360 và đang được chốt giá — bạn có thể đọc tài liệu và chuẩn bị tích hợp trước.
Mô tả API
Mọi VIỆC liên quan tới MỘT người (người làm hoặc người giao) trên các dự án: dùng cho báo cáo khối lượng / tiến độ theo nhân viên.
- Gồm cả việc người đó GIAO cho người khác (creator_username = user), không chỉ việc được giao — lọc
usernamenếu chỉ cần việc phải làm. - Thiếu
user→code0,Invalid username.
Request
Địa chỉ
POST https://partner.quantri360.com/v1/base_wework/extapi/v3/user/tasks
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 | heradg | Tên kết nối Base Wework (GET /v1/platforms). Có thể bỏ khi chỉ nối một token. |
| username | body | string | @nguyenvana | API ghi chạy DƯỚI TÊN người dùng Base này (kèm @). |
Tham số request
| Tên | Vị trí | Kiểu | Bắt buộc | Mẫu | Mô tả |
|---|---|---|---|---|---|
| user | body | string | Có | nguyenvana | Username Base (có hoặc không kèm @ đều được). |
Ví dụ request
curl -s -X POST "https://partner.quantri360.com/v1/base_wework/extapi/v3/user/tasks" \
-H "Authorization: Bearer $KEY" \
-H "Content-Type: application/json" \
-d '{"user":"nguyenvana"}'
Python
import requests
KEY = "q360_live_..." # khóa API của brand
r = requests.post(
"https://partner.quantri360.com/v1/base_wework/extapi/v3/user/tasks",
params={},
json={
"user": "nguyenvana"
},
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/base_wework/extapi/v3/user/tasks');
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({"user":"nguyenvana"}),
});
console.log(r.status, await r.json());PHP
<?php
$key = 'q360_live_...'; // khóa API của brand
$url = 'https://partner.quantri360.com/v1/base_wework/extapi/v3/user/tasks' . '?' . 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, '{"user":"nguyenvana"}');
$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 Base Wework)
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| code | int | 1 | 1 = thành công · 0 = lỗi (vd `Invalid username`). |
| total | int | 7 | Tổng việc. |
| tasks | object[] | Như phần tử task/project: id, name, metatype, username (người làm), creator_username (người giao), project_id, deadline, status, complete… |
Mẫu phản hồi
{
"code": 1,
"message": "",
"data": null,
"total": 7,
"tasks": [
{
"id": "13675403",
"name": "Làm báo cáo sx t8",
"metatype": "task",
"username": "nguyenvana",
"creator_username": "hoangvane",
"project_id": "229079",
"deadline": "1788713999",
"status": "1",
"complete": "100.00"
},
{
"id": "13674627",
"name": "Check với NCC",
"metatype": "subtask",
"username": "",
"creator_username": "nguyenvana",
"project_id": "229078",
"status": "0"
}
]
}
Bắt đầu dùng
- Đăng ký tài khoản Partner
- Mở loại dữ liệu thuộc nhóm Công việc ở trang nền tảng
- Tạo API key (tick kênh Base Wework)
- Gọi theo ví dụ ở trên