---
title: "Ghi nhận một lượt sử dụng mẫu (add-in gọi sau khi chèn / mở / tải)"
method: POST
path: "/excel/templates/{templateId}/usages"
tags: ["ExcelTemplates"]
---

# Ghi nhận một lượt sử dụng mẫu (add-in gọi sau khi chèn / mở / tải)

`POST /excel/templates/{templateId}/usages`

## Request

- Base URL: `https://api.fireant.vn`
- URL: `https://api.fireant.vn/excel/templates/{templateId}/usages`
- Auth: OAuth 2
  - Implicit: `https://accounts.fireant.vn/connect/authorize`
  - Scopes: `user-data-write`
- TypeScript: <https://skmtc.dev/fireant/apis/fireant-restful-api/docs/excel/templates/:templateId/usages/post.ts> (a function with typed inputs; its response is checked against the schema)

Chỉ khi được dùng mẫu (canUse). Mọi lượt đều được ghi; usageCount chỉ tăng một lần cho mỗi người dùng / mẫu trong 60 phút.

## Path parameters

- `templateId` integer, required

## Query parameters

- `token` string

## Request body

- FireAntApiModelsExcelTemplatesExcelTemplateUsageRequest: Ghi nhận một lượt sử dụng mẫu (add-in gửi sau khi chèn / mở / tải mẫu)
  - `action` 1 | 2 | 3: Hành động: 1 Insert, 2 Open, 3 Download (1 = Insert, 2 = Open, 3 = Download)
  - `platform` string: Nền tảng (Office.context.platform: PC, Mac, OfficeOnline, iOS...), tối đa 20 ký tự ASCII
  - `appVersion` string: Phiên bản add-in, tối đa 20 ký tự ASCII

## Response `200`

usageCount hiện tại

- FireAntApiModelsExcelTemplatesExcelTemplateUsageResult: Kết quả ghi nhận sử dụng
  - `usageCount` integer: Số lượt sử dụng hiện tại của mẫu

## Other responses

- `400`: Dữ liệu không hợp lệ
- `403`: Chưa đủ hạng thành viên
- `404`: Mẫu không tồn tại hoặc không xem được

## Changes

- **2026-10-10** `300cfd8b632c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fireant/apis/fireant-restful-api/changes/excel/templates/:templateId/usages/post.md)

---

[API](https://skmtc.dev/fireant/apis/fireant-restful-api.md) - [All operations](https://skmtc.dev/fireant/apis/fireant-restful-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fireant/apis/fireant-restful-api/revisions/c9b3aa855f95?raw)