API Analytics

API Reference Cập nhật: 23/03/2026

Analytics API

Thống kê giao dịch, tài khoản và trạng thái dịch vụ.

Tổng quan

GET /api/v1/analytics/overview
Authorization: Bearer YOUR_API_KEY

Response

{
  "status": true,
  "messages": "Thành công",
  "overview": {
    "total_transactions": 35,
    "total_in": 3436800,
    "total_out": 1330000,
    "bank_accounts": 1,
    "webhooks_sent": 35,
    "webhooks_errors": 0
  }
}

Mô tả trường

Trường	Kiểu	Mô tả
total_transactions	integer	Tổng số giao dịch
total_in	integer	Tổng tiền vào (VND)
total_out	integer	Tổng tiền ra (VND)
bank_accounts	integer	Số tài khoản ngân hàng
webhooks_sent	integer	Tổng webhook đã gửi
webhooks_errors	integer	Webhook gửi lỗi

Thống kê theo kỳ

GET /api/v1/analytics/period?range=monthly
Authorization: Bearer YOUR_API_KEY

Query Parameters

Param	Giá trị	Mô tả
range	`daily`	1 ngày gần nhất
	`weekly`	7 ngày gần nhất
	`monthly`	30 ngày gần nhất (mặc định)

Response

{
  "status": true,
  "messages": "Thành công",
  "range": "monthly",
  "data": [
    {
      "date": "2026-03-22",
      "type": "IN",
      "count": 33,
      "total": 3436800
    },
    {
      "date": "2026-03-22",
      "type": "OUT",
      "count": 2,
      "total": 1330000
    }
  ]
}

Mô tả trường data

Trường	Kiểu	Mô tả
date	string	Ngày (Y-m-d)
type	string	IN hoặc OUT
count	integer	Số giao dịch
total	integer	Tổng tiền (VND)

Trạng thái tài khoản

GET /api/v1/analytics/status
Authorization: Bearer YOUR_API_KEY

Response

{
  "status": true,
  "messages": "Thành công",
  "account": {
    "plan": "Nano",
    "expires_at": "2027-03-22 07:25:47",
    "is_trial": false,
    "bank_accounts": 1,
    "max_bank_accounts": 1,
    "webhooks": 1
  }
}

Mô tả trường account

Trường	Kiểu	Mô tả
plan	string	Tên gói đang dùng
expires_at	string	Ngày hết hạn
is_trial	boolean	Đang dùng thử hay không
bank_accounts	integer	Số TK đang dùng
max_bank_accounts	integer	Giới hạn TK của gói
webhooks	integer	Số webhook đang active

Ví dụ cURL

# Tổng quan
curl -s "https://thueapi.vn/api/v1/analytics/overview" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Theo kỳ
curl -s "https://thueapi.vn/api/v1/analytics/period?range=monthly" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Trạng thái
curl -s "https://thueapi.vn/api/v1/analytics/status" \
  -H "Authorization: Bearer YOUR_API_KEY"