Cổng Nhà phát triển và Xác thực RESTful API

SolidSuite được thiết kế theo kiến trúc API-First, cung cấp đầy đủ các điểm cuối (Endpoints) RESTful API chuẩn mực, bảo mật, giúp các kỹ sư phần mềm dễ dàng tích hợp SolidSuite với các hệ thống ERP, Phần mềm Kế toán, Tổng đài VoIP hoặc Ứng dụng di động nội bộ của doanh nghiệp.

1. Nguyên tắc xác thực API (Authentication)

Tất cả các yêu cầu API gửi đến máy chủ SolidSuite đều bắt buộc phải kèm theo Header xác thực:

Authorization: Bearer <YOUR_API_KEY>
X-Tenant-Id: <YOUR_TENANT_ID>
Content-Type: application/json

• Môi trường API chính thức: https://api.solidsuite.vn
• Định dạng dữ liệu: 100% Request và Response đều sử dụng định dạng JSON chuẩn.

2. Quy trình tạo API Key mới

1. 1

   Truy cập Cổng Nhà phát triển

   Đăng nhập với quyền Quản trị viên, truy cập SolidAdmin > Nhà phát triển & API (đường dẫn /developers/api).

2. 2

   Tạo Khóa truy cập mới (API Key)

   Nhấp nút + Tạo API Key mới:

   • Đặt tên gợi nhớ cho khóa (ví dụ: Tích hợp Tổng đài VoIP FPT, Đồng bộ Phần mềm Kế toán MISA).
   • Chọn phạm vi quyền hạn (Scopes): Đọc dữ liệu (Read-only) hoặc Toàn quyền (Read/Write) trên các phân hệ HRM, CRM, Work.
   • Thiết lập thời hạn hiệu lực của khóa.
3. 3

   Lưu trữ Khóa bảo mật

   Hệ thống sẽ hiển thị mã Secret Key duy nhất một lần. Hãy sao chép và lưu trữ mã này vào kho quản lý bí mật an toàn (như Vault hoặc file .env).

3. Ví dụ gọi API lấy danh sách Khách hàng (cURL)

curl -X GET "https://api.solidsuite.vn/crm/customers?page=1&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE" \
  -H "X-Tenant-Id: your_tenant_code" \
  -H "Content-Type: application/json"

Cấu trúc phản hồi chuẩn (Response Format):

{
  "success": true,
  "message": "Success",
  "data": [
    {
      "id": "cust_98234",
      "name": "Công ty Cổ phần Công nghệ ABC",
      "taxCode": "0109876543",
      "email": "contact@abc-tech.vn",
      "phone": "02439998888",
      "createdAt": "2026-08-31T08:00:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 142
  }
}