sangtao.ai
API key

Tài khoản

Lịch sử giao dịch

Mọi lần credit thay đổi trên tài khoản, mới nhất trước: nạp, trừ, hoàn.

GEThttps://api.sangtao.ai/v2/account/transactions

Xác thực

  • X-Api-Keystring · headerbắt buộc

    API key của bạn, tạo ở trang API key trong tài khoản.

Tham số query

  • typestring

    Chỉ lấy giao dịch loại này. Không phân biệt hoa thường.

    Giá trị có thể:TopupConsumeBonusRefundAdjustmentExchange

  • pageint

    Số trang, từ 1. Mặc định 1.

  • pageSizeint

    Số giao dịch mỗi trang. Mặc định 20, tối đa 100. Gửi limit cũng được, cùng nghĩa.

Response

Một mảng giao dịch, mới nhất trước. Tổng số theo bộ lọc nằm ở header X-Total-Count.

  • idstring

    Mã giao dịch, tx_….

  • typestring

    Loại giao dịch.

    Giá trị có thể:TopupConsumeBonusRefundAdjustmentExchange

  • descriptionstring

    Nội dung giao dịch, dạng câu (tiếng Việt).

  • descriptionKeystring | null

    Loại câu, để tự viết description bằng ngôn ngữ của bạn, ví dụ "bank_topup". null nếu không có.

  • descriptionParamsobject | null

    Các giá trị trong câu đó (số tiền, gói…), dạng chuỗi.

  • amountnumber

    Số credit cộng (dương) hoặc trừ (âm).

  • balanceAfternumber

    Số dư ngay sau giao dịch.

  • jobIdstring | null

    Job liên quan. null nếu không gắn với job (ví dụ nạp credit).

  • createdAtstring

    Thời điểm giao dịch, ISO 8601 giờ UTC.

GET/account/transactions
curl "https://api.sangtao.ai/v2/account/transactions?page=1&pageSize=20" \
  -H "X-Api-Key: YOUR_API_KEY"
{
  "success": true,
  "data": [
    {
      "id": "tx_8hQ2mZr4K",
      "type": "Consume",
      "description": "Motion render",
      "descriptionKey": "motion_render",
      "descriptionParams": {},
      "amount": -12,
      "balanceAfter": 142,
      "jobId": "acff47cbfacf4e27bbc08770c9ea246d",
      "createdAt": "2026-11-09T10:01:00Z"
    },
    {
      "id": "tx_3kT9qPz0B",
      "type": "Topup",
      "description": "Nạp 200.000đ — Gói Starter",
      "descriptionKey": "bank_topup",
      "descriptionParams": {
        "vnd": "200000",
        "package": "Gói Starter"
      },
      "amount": 150,
      "balanceAfter": 154,
      "jobId": null,
      "createdAt": "2026-11-08T03:20:00Z"
    }
  ]
}