API Documentation

Số dư

CCCD

Biển số

Zalo API

AI Chat

Lịch sử

GET /api/user/balance

Lấy thông tin số dư hiện tại của tài khoản người dùng.

Cấu trúc phản hồi (Response)

Trường	Kiểu dữ liệu	Mô tả
status	String	Trạng thái request (success/error)
balance	Number	Số dư hiện tại
currency	String	Đơn vị tiền tệ (VND)

Dùng thử API

POST /api/info_cccd

Trích xuất thông tin từ ảnh Căn cước công dân (Mặt trước/Mặt sau).

Tham số gửi đi (Request Parameters)

Trường	Kiểu	Bắt buộc	Mô tả
image[]	File	YES	File ảnh CCCD (JPG/PNG). Hỗ trợ upload tối đa 2 ảnh cùng lúc.

Dùng thử API

Chọn ảnh CCCD

POST /api/license-plate

Nhận diện và đọc biển số xe từ hình ảnh (Xe máy, Ô tô).

Tham số gửi đi (Request Parameters)

Trường	Kiểu	Bắt buộc	Mô tả
images[]	File	YES	File ảnh chứa phương tiện.

Dùng thử API

Chọn ảnh xe

POST /api/account-login

Khởi tạo phiên đăng nhập Zalo mới. Trả về mã QR để người dùng quét.

Tham số gửi đi (Request)

Trường	Kiểu	Mô tả
Không yêu cầu tham số (Body rỗng {})

Dữ liệu trả về (Response)

Trường	Kiểu	Mô tả
sessionId	String	ID phiên (Lưu lại để check status)
qrCode	String	Mã QR (Base64/URL)

QR Code sẽ hiện ở đây

POST /api/login-status

Kiểm tra trạng thái quét mã QR (Chờ quét, Đã quét, Hết hạn).

Tham số gửi đi (Request)

Trường	Kiểu	Bắt buộc	Mô tả
sessionId	String	YES	Mã phiên nhận được từ bước tạo QR.

JSON Body

POST /api/webhook-config

Cấu hình Webhook để nhận tin nhắn callback từ Zalo về Server của bạn.

Tham số gửi đi (Request)

Trường	Kiểu	Bắt buộc	Mô tả
account_id	String	YES	Zalo ID hoặc SĐT tài khoản quản lý.
config	Object	YES	Đối tượng chứa thông tin cài đặt.
└ enabled	Boolean	YES	Bật/Tắt webhook (true/false).
└ webhookUrl	String	YES	URL Server nhận callback (Method POST).
└ filters	Object	NO	Bộ lọc tin nhắn nâng cao.

JSON Body

POST /api/sendMessage

Gửi tin nhắn văn bản đến người dùng hoặc nhóm chat.

Tham số gửi đi (Request)

Trường	Kiểu	Bắt buộc	Mô tả
account_id	String	YES	Zalo ID người gửi.
thread_id	String	YES	ID người nhận hoặc ID nhóm (là ID đoạn chat trả về webhook khi nhận tin nhắn, không phải id người dùng hay nhóm).
thread_type	Integer	YES	User hoặc Group.
message	String	YES	Nội dung tin nhắn.

JSON Body

POST /api/ai_chat

Tương tác với các mô hình ngôn ngữ lớn (LLM) như GPT-4, Claude,...

Bảng giá Model (Trên 1 Triệu Token)

Model Name	Input Price	Output Price
gpt-4	800.000VND	800.000VND
gpt-4.1	105.000VND	420.000VND
gpt-4o-mini	10.000VND	10.000VND

Tham số gửi đi (Request)

Trường	Kiểu	Bắt buộc	Mô tả
model	String	YES	Tên mô hình AI (Ví dụ: `gpt-4o-mini`)
prompt	String	NO	Hướng dẫn hệ thống (System instruction) cho AI.
mess	String	YES	Nội dung câu hỏi hoặc tin nhắn của người dùng.

Dữ liệu trả về (Response)

Trường	Kiểu	Mô tả chi tiết
message	Object	Chứa nội dung phản hồi từ AI.
└ role	String	Vai trò (thường là "assistant").
└ content	String	Nội dung câu trả lời.
usage	Object	Thông tin về token và chi phí.
└ prompt_tokens	Int	Số token đầu vào.
└ completion_tokens	Int	Số token đầu ra.
└ total_price_vnd	Int	Tổng chi phí ước tính (VND).

Chat Demo

JSON Body

GET /api/user/log_api

Xem lịch sử các yêu cầu API đã thực hiện.

Tham số gửi đi (Request)

Trường	Kiểu	Bắt buộc	Mô tả
start_date	Date	NO	Ngày bắt đầu (YYYY-MM-DD)
end_date	Date	NO	Ngày kết thúc (YYYY-MM-DD)

Dữ liệu trả về (Response)

Trường	Kiểu	Mô tả
history[]	Array	Danh sách log
total	Integer	Tổng số request

Từ ngày

Đến ngày