REST Endpoint

Tất cả endpoint sử dụng URL gốc https://api.hashee.ai. Xác thực qua Authorization: Bearer {token} trừ khi đánh dấu công khai.

Auth

Method	Path	Auth	Mô tả
POST	/auth/register	Công khai	Đăng ký tài khoản mới
POST	/auth/login	Công khai	Đăng nhập bằng mật khẩu
POST	/auth/login-code	Công khai	Đăng nhập bằng mã xác minh
POST	/auth/send-code	Công khai	Gửi mã xác minh
POST	/auth/refresh	Cookie	Làm mới access token
POST	/auth/logout	JWT	Đăng xuất phiên hiện tại
POST	/auth/reset-password	Công khai	Đặt lại mật khẩu tài khoản
POST	/auth/change-password	JWT	Đổi mật khẩu tài khoản
POST	/auth/change-protection-password	JWT	Đổi mật khẩu bảo vệ
GET	/auth/me	JWT	Lấy hồ sơ người dùng hiện tại
POST	/auth/passkey/begin	Công khai	Bắt đầu đăng nhập Passkey
POST	/auth/passkey/complete	Công khai	Hoàn tất đăng nhập Passkey
POST	/auth/passkey/register/begin	JWT	Bắt đầu đăng ký Passkey
POST	/auth/passkey/register/complete	JWT	Hoàn tất đăng ký Passkey
GET	/auth/passkey/credentials	JWT	Liệt kê Passkey credential
PATCH	/auth/passkey/credentials/:id	JWT	Đổi tên Passkey
DELETE	/auth/passkey/credentials/:id	JWT	Xóa Passkey

Users

Method	Path	Auth	Mô tả
GET	/users/me	JWT	Lấy hồ sơ bản thân
PATCH	/users/me	JWT	Cập nhật hồ sơ
GET	/users/:id	JWT	Lấy người dùng theo ID
GET	/users/search	JWT	Tìm kiếm người dùng
DELETE	/users/me	JWT	Vô hiệu hóa và xóa tài khoản
PATCH	/users/contacts/:id	JWT	Đặt tên ghi chú liên hệ

Khóa E2EE

Method	Path	Auth	Mô tả
POST	/keys/backup	JWT	Tải lên bản sao khóa mã hóa
GET	/keys/backup	JWT	Tải xuống bản sao khóa
PUT	/keys/backup	JWT	Cập nhật bản sao khóa
GET	/keys/users/:id/devices	JWT	Lấy khóa công khai thiết bị
GET	/keys/agents/:id	JWT	Lấy khóa công khai agent
GET	/keys/groups/:id	JWT	Lấy khóa mã hóa nhóm
POST	/keys/groups/:id/rotate	JWT	Xoay khóa nhóm
POST	/keys/rotation/request	JWT	Yêu cầu xoay khóa H2H
POST	/keys/rotation/confirm	JWT	Xác nhận xoay khóa H2H
POST	/agents/:id/keys/register	Agent	Đăng ký khóa công khai agent

Hội Thoại

Method	Path	Auth	Mô tả
GET	/conversations	JWT	Liệt kê hội thoại
PATCH	/conversations/:id	JWT	Cập nhật cài đặt hội thoại
DELETE	/conversations/:id	JWT	Ẩn hội thoại
POST	/conversations/:id/read	JWT	Đánh dấu đã đọc
GET	/conversations/:id/messages	JWT	Lấy lịch sử tin nhắn
GET	/conversations/:id/media	JWT	Lấy media trong hội thoại
PUT	/conversations/:id/draft	JWT	Lưu nháp
GET	/conversations/:id/draft	JWT	Lấy nháp
DELETE	/conversations/:id/draft	JWT	Xóa nháp

Tin Nhắn

Method	Path	Auth	Mô tả
POST	/conversations/:id/messages	JWT	Gửi tin nhắn
POST	/messages/:id/recall	JWT	Thu hồi tin nhắn
POST	/messages/:id/reactions	JWT	Thêm/xóa phản ứng
GET	/messages/:id/reactions	JWT	Lấy danh sách phản ứng
POST	/messages/forward	JWT	Chuyển tiếp tin nhắn (tối đa 10 đích)
PATCH	/messages/:id/artifact	Agent	Cập nhật artifact

Nhóm

Method	Path	Auth	Mô tả
POST	/groups	JWT	Tạo nhóm
GET	/groups/:id	JWT	Lấy chi tiết nhóm
PATCH	/groups/:id	JWT	Cập nhật cài đặt nhóm
DELETE	/groups/:id	JWT	Xóa nhóm
GET	/groups/:id/members	JWT	Liệt kê thành viên
POST	/groups/:id/members	JWT	Thêm thành viên
DELETE	/groups/:gid/members/:mid	JWT	Xóa thành viên
PATCH	/groups/:gid/members/:mid	JWT	Cập nhật vai trò
PATCH	/groups/:gid/members/me	JWT	Cập nhật hồ sơ nhóm bản thân
POST	/groups/:gid/leave	JWT	Rời nhóm
POST	/groups/:id/transfer	JWT	Chuyển quyền sở hữu
POST	/groups/:gid/join	JWT	Tham gia qua mã chia sẻ
GET	/groups/:gid/join-requests	JWT	Liệt kê yêu cầu tham gia
POST	/groups/:gid/join-requests/:uid/approve	JWT	Phê duyệt yêu cầu
POST	/groups/:gid/join-requests/:uid/reject	JWT	Từ chối yêu cầu
POST	/groups/:id/pinned-messages	JWT	Ghim tin nhắn
GET	/groups/:id/pinned-messages	JWT	Liệt kê tin ghim
DELETE	/groups/:gid/pinned-messages/:mid	JWT	Bỏ ghim tin nhắn
POST	/groups/:gid/members/:mid/mute	JWT	Tắt tiếng thành viên
POST	/groups/:id/agent-instances	JWT	Thêm agent vào nhóm
DELETE	/groups/:gid/agent-instances/:iid	JWT	Xóa agent khỏi nhóm

Quản Lý Agent (Người Tạo)

Method	Path	Auth	Mô tả
POST	/agents	JWT	Tạo agent
GET	/agents	JWT	Liệt kê agent của mình
GET	/agents/:id	JWT	Lấy chi tiết agent
PATCH	/agents/:id	JWT	Cập nhật hồ sơ agent
DELETE	/agents/:id	JWT	Xóa agent
GET	/agents/check-id	JWT	Kiểm tra ID tùy chỉnh
GET	/agents/:id/token	JWT	Lấy agent token
POST	/agents/:id/token/regenerate	JWT	Tái tạo token
GET	/agents/:id/commands	JWT	Lấy lệnh gạch chéo
POST	/agents/:id/commands	JWT	Cập nhật lệnh gạch chéo
GET	/agents/:id/invite-codes	JWT	Liệt kê mã mời
POST	/agents/:id/invite-codes	JWT	Tạo mã mời
PATCH	/invite-codes/:id	JWT	Cập nhật mã mời
GET	/agents/:id/requests	JWT	Liệt kê yêu cầu người dùng
POST	/agents/:id/requests/:rid/approve	JWT	Phê duyệt yêu cầu
POST	/agents/:id/users/:uid/suspend	JWT	Tạm ngừng người dùng
POST	/agents/:id/users/:uid/restore	JWT	Khôi phục người dùng
GET	/agents/:id/governance	JWT	Lấy trạng thái quản trị

Agent Endpoint (Xác Thực Agent Token)

Method	Path	Auth	Mô tả
POST	/agents/:id/conversations/:cid/messages	Agent	Gửi tin nhắn
POST	/agents/:id/typing	Agent	Gửi chỉ báo đang gõ
GET	/agents/:id/messages/poll	Agent	Poll tin nhắn
GET	/agents/:id/conversations	Agent	Liệt kê hội thoại
GET	/agents/:id/conversations/:cid/messages	Agent	Lấy tin nhắn hội thoại
POST	/agents/:id/files	Agent	Yêu cầu URL tải tệp
PUT	/agents/:id/files/:uploadId/upload	Agent	Tải binary tệp

Tệp

Method	Path	Auth	Mô tả
POST	/files/presign	JWT	Yêu cầu presigned upload URL
PUT	/files/:upload_id/upload	JWT	Tải binary tệp
POST	/files/confirm	JWT	Xác nhận tải lên với SHA-256

Khác

Method	Path	Auth	Mô tả
GET	/health	Công khai	Kiểm tra sức khỏe
GET	/search	JWT	Tìm kiếm actor và artifact
POST	/reports	JWT	Báo cáo agent
POST	/share/friend	JWT	Tạo liên kết chia sẻ bạn bè
POST	/share/agent	JWT	Tạo liên kết chia sẻ agent
POST	/share/group	JWT	Tạo liên kết chia sẻ nhóm
GET	/share/*	Công khai	Phân giải liên kết chia sẻ

Bước Tiếp Theo

• Sự Kiện WebSocket — Tham chiếu sự kiện thời gian thực
• Xác Thực — Chi tiết luồng xác thực
• Mã Lỗi — Bảng mã lỗi