Lập trình viên
Terranimus, dưới dạng API.
Mỗi sản phẩm của Terranimus đang có API riêng, kèm tài liệu, key và hạn mức. Các chức năng đó cũng có sẵn dưới dạng MCP tool cho AI client. Trang này liệt kê API bạn gọi được ngay, API đang xây, và mỗi API cần gì ở phía bạn.
Danh mục API
Những gì bạn gọi được.
Memo
Đang chạyMemory và retrieval trên tài liệu của chính bạn. Bạn tìm kiếm, lấy ngữ cảnh cho prompt, nhận câu trả lời có trích nguồn và ghi tài liệu vào kho. AI client dùng cùng memory đó qua MCP tool.
- Dành cho
- Lập trình viên và doanh nghiệp đang làm trợ lý AI, cùng mọi ứng dụng của Terranimus.
- Xác thực
- REST: gửi key memo_ dạng Bearer token (hoặc header X-API-Key), quyền giới hạn theo scope của key. MCP: đăng nhập OAuth 2.1 bằng tài khoản của bạn, hoặc dùng chính key đó.
- Dạng key
memo_<region>_…- Scope
readwriteingestsharedanswerusagememo:memory
Hai endpoint answer và chat có gọi language model nên trừ vào số dư nạp trước.
Marketing MCP
Đang chạyWorkspace Terranimus Marketing dưới dạng MCP tool. Ngay trong ChatGPT, Claude hoặc MCP client bất kỳ, bạn lên kế hoạch và soạn nội dung, chăm sóc lead, chuẩn bị lịch hẹn. Mọi thao tác chạy với tư cách người đã đăng nhập.
- Dành cho
- Doanh nghiệp khách hàng muốn điều hành workspace marketing từ trợ lý AI.
- Xác thực
- OAuth 2.1 có PKCE, với tư cách thành viên đã đăng nhập vào workspace. Scope tăng dần: đọc, ghi, rồi duyệt. Đăng bài, gửi thư và mọi thao tác ra bên ngoài đều chờ người dùng xác nhận trong web app.
- Scope
marketing:readmarketing:writemarketing:approve
Đã bật sau khi đợt rà soát bảo mật độc lập đạt yêu cầu.
Recruit MCP
Đang chạyWorkspace Terranimus Recruit dưới dạng MCP tool. Hệ thống tách tin tuyển dụng của nhà tuyển dụng trực tiếp khỏi tin của công ty tuyển dụng. Với tin của công ty tuyển dụng, bạn thấy khách hàng nhiều khả năng đứng sau. Bạn cũng quản lý khách tiềm năng và danh sách công ty tuyển dụng. Mọi thao tác chạy với tư cách người đã đăng nhập.
- Dành cho
- Chuyên viên tuyển dụng và nhóm bán hàng muốn liên hệ thẳng nhà tuyển dụng đứng sau tin đăng.
- Xác thực
- OAuth 2.1 có PKCE, với tư cách thành viên đã đăng nhập vào workspace. Scope tăng dần: đọc, ghi, rồi duyệt. Xác nhận khách hàng, xoá dữ liệu hay đổi thành viên đều chờ người dùng xác nhận trong web app.
- Scope
recruit:readrecruit:writerecruit:approve
Đã bật sau khi đợt rà soát bảo mật độc lập đạt yêu cầu. Nội dung tin tuyển dụng do người lạ viết nên trả về trong trường đánh dấu là không tin cậy.
Identity
Đang chạyĐăng nhập và phân quyền cho ứng dụng qua OpenID Connect. API trả thông tin người đang đăng nhập, tổ chức và thành viên, kiểm tra quyền truy cập và đăng ký ứng dụng.
- Dành cho
- Các ứng dụng của Terranimus, và doanh nghiệp khách hàng muốn ứng dụng riêng đăng nhập bằng Terranimus.
- Xác thực
- OpenID Connect. Mỗi lệnh gọi API mang một JWT access token cấp riêng cho Identity API (xin bằng tham số resource=). ID token không bao giờ dùng để xác thực API.
Identity sẽ là nơi duy nhất cấp key, gói và ghi nhận lượt dùng cho mọi API khác.
Gói
Bộ gói mà mọi API đang chuyển sang.
Mọi sản phẩm sẽ dùng chung một bộ gói khi key được cấp tập trung. Trước đó, mỗi API áp hạn mức riêng, ghi kèm tài liệu của API đó. Hạn mức tính theo key hoặc theo lượt cấp quyền đăng nhập, không tính theo địa chỉ IP. Gọi vượt hạn mức thì nhận mã 429 kèm Retry-After, và nội dung trả về nói rõ khung thời gian nào đã chạm trần.
| Gói | Mỗi phút | Mỗi tháng |
|---|---|---|
| Free | 60 | 1.000 |
| Dev | 600 | 50.000 |
| Pro | 3.000 | 1.000.000 |
| Enterprise | Theo hợp đồng | |
- Giá tính bằng AUD và VND, chốt riêng cho từng sản phẩm khi ra mắt.
- Endpoint nào gọi language model thì chỉ chạy bằng số dư nạp trước.
- Chỉ gói enterprise có SLA, và chỉ khi sản phẩm đó chạy trên hai server.
Chuẩn chung
Chuẩn mà mọi API đang chuyển sang.
- Đường dẫn có phiên bản (/v1). Thay đổi làm vỡ tương thích ra mắt dưới /v2, chạy song song, báo trước ít nhất sáu tháng.
- Key mang tên sản phẩm và môi trường (live hoặc test), chỉ hiện một lần, chỉ lưu bản băm, thu hồi được.
- API REST nào cũng có tài liệu OpenAPI 3.1. MCP tool gọi đúng các hàm đó, nên hai bên không lệch nhau.
- Một định dạng lỗi chung, và phản hồi nào cũng có request id.
- Thao tác ra bên ngoài như gửi thư, đăng bài hay thu tiền đều chờ một người xác nhận trong ứng dụng.
- Nội dung do bên thứ ba viết luôn nằm trong một trường đánh dấu là không tin cậy, không bao giờ trộn vào chỉ dẫn.
Quyền truy cập
Xin key.
Hiện chúng tôi cấp key thủ công, trong lúc xây phần tự tạo key. Viết thư cho chúng tôi, ghi rõ sản phẩm, việc bạn đang làm và gói bạn dự kiến cần.
Cho AI agent
Cùng danh sách này, dạng văn bản thuần.
Mọi API kèm địa chỉ và cách xác thực, theo kiểu llms.txt, để agent và script đọc.