TG ONE API Reference
Tải danh mục JSON

API tích hợp hệ sinh thái

Các route đang được triển khai trong mã nguồn TG ONE. Không bao gồm API riêng chưa được đăng ký của HR, Invoice, ERP hoặc ứng dụng khác.

166 đường dẫn · 252 methodCập nhật 2/11/2026https://api.tgone.vn

Kết nối từ backend

Chọn API trong danh mục bên trái để xem thông tin và code mẫu cURL hoặc JavaScript.

  1. Superadmin cấp credential và scope tại IOC.
  2. Backend ứng dụng lấy service token qua .
  3. Gửi Authorization: Bearer <access_token> cho API hỗ trợ service token.
  4. Kiểm tra Tenant, Company, kích hoạt dịch vụ và App Role theo contract của API.

Không đặt Client Secret trong trình duyệt. Token sống 15 phút. Credential sai/hết hạn: 401; scope chưa cấp: 403; thiếu cấu hình ký token: 503.

Shared Master

/tgone/v1/master/{catalog} hỗ trợ GET. Catalog: company-types, positions, position-groups, career-levels, functional-areas. Scope đọc tương ứng: tgone.company_type.read, tgone.position.read, tgone.master.read. Query: q hoặc keyword, status (ACTIVE/INACTIVE), page, limit (tối đa 100). Ghi master dùng quyền quản trị IOC.