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

Việc của một người (user, page) — API Base Wework

user/tasks · 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.

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 username nếu chỉ cần việc phải làm.
  • Thiếu user → code 0, 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ê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_idquerystringheradgTên kết nối Base Wework (GET /v1/platforms). Có thể bỏ khi chỉ nối một token.
usernamebodystring@nguyenvanaAPI ghi chạy DƯỚI TÊN người dùng Base này (kèm @).

Tham số request

TênVị tríKiểuBắt buộcMẫuMô tả
userbodystringCónguyenvanaUsername 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ênKiểuMẫuMô tả
codeint11 = thành công · 0 = lỗi (vd `Invalid username`).
totalint7Tổng việc.
tasksobject[]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

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