Tài liệu API AxisMeet

Tham số

Ví dụ

curl -X POST https://meet.axisdev.vn/api/v1/phong \
  -H "Authorization: Bearer $AXISMEET_KEY:$AXISMEET_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "ten": "Lớp TCF nhóm buổi tối",
    "cheDo": "GROUP",
    "soNguoiToiDa": 8,
    "maNgoai": "buoi-2026-09-28-A"
  }'

Phản hồi · 201

{
  "thanhCong": true,
  "duLieu": {
    "maPhong": "kmt-pdrs-nhq",
    "ten": "Lớp TCF nhóm buổi tối",
    "cheDo": "GROUP",
    "trangThai": "OPEN",
    "soNguoiToiDa": 8,
    "maChuPhong": null,
    "maKhach": null,
    "maNgoai": "buoi-2026-09-28-A",
    "lienKetThamGia": "https://meet.axisdev.vn/phong/kmt-pdrs-nhq",
    "taoLuc": "2026-09-28T12:00:00.000Z"
  }
}

Tham số truy vấn

Mỗi phòng trả kèm soNguoiDangTrongPhong đếm trực tiếp từ máy chủ video — dùng được để hiện dấu "đang có người" trên lịch của bạn.

Trả về đầy đủ thông tin phòng và lichSuThamGia — 50 lượt gần nhất, mỗi lượt có tên, thời điểm vào, thời điểm ra và số giây có mặt. Đây là số liệu để đối chiếu giờ dạy.

{
  "thanhCong": true,
  "duLieu": {
    "maPhong": "kmt-pdrs-nhq",
    "trangThai": "OPEN",
    "soNguoiDangTrongPhong": 3,
    "lichSuThamGia": [
      {
        "ten": "Cô Lan",
        "danhTinh": "gv-17",
        "vaiTro": "HOST",
        "vaoLuc": "2026-09-28T12:01:10.000Z",
        "raLuc": "2026-09-28T13:32:44.000Z",
        "soGiay": 5494
      }
    ]
  }
}

Ba trạng thái phòng

• OPEN — ai có mã đều vào được.
• LOCKED — chỉ vé vai trò HOST vào được. Dùng khi lớp đã bắt đầu và không muốn ai vào giữa chừng.
• CLOSED — đóng hẳn, người đang trong phòng bị ngắt kết nối.

Tương đương đổi trangThai sang CLOSED. Bản ghi phòng vẫn giữ lại để tra số liệu về sau, không bị xóa khỏi hệ thống.

Gọi mỗi khi một người bấm vào lớp. Vé có hiệu lực 4 giờ và chỉ dùng được cho đúng phòng đó. Đây là chỗ hệ thống của bạn quyết định ai được vào — AxisMeet không biết học viên của bạn là ai.

Tham số

Ví dụ

curl -X POST https://meet.axisdev.vn/api/v1/phong/kmt-pdrs-nhq/ve \
  -H "Authorization: Bearer $AXISMEET_KEY:$AXISMEET_SECRET" \
  -H "Content-Type: application/json" \
  -d '{ "danhTinh": "gv-17", "ten": "Cô Lan", "vaiTro": "HOST" }'

Phản hồi · 200

{
  "thanhCong": true,
  "duLieu": {
    "maPhong": "kmt-pdrs-nhq",
    "ten": "Lớp TCF nhóm buổi tối",
    "maTruyCap": "eyJhbGciOiJIUzI1NiJ9...",
    "diaChiMayChu": "wss://meet.axisdev.vn",
    "hetHanLuc": "2026-09-28T16:00:00.000Z",
    "maDieuKhien": "eyJhbGciOiJIUzI1NiJ9...",
    "choPhepGhiHinh": true,
    "lienKetThamGia": "https://meet.axisdev.vn/phong/kmt-pdrs-nhq?ve=..."
  }
}

Không cần xác thực. Trả về phòng có đang được ghi hay không, ai bật và bật từ lúc nào.

{
  "thanhCong": true,
  "duLieu": {
    "choPhep": true,
    "dangGhi": true,
    "dangXuLy": false,
    "batDauLuc": "2026-09-28T12:05:00.000Z",
    "nguoiBatDau": "Cô Lan"
  }
}

Gửi kèm header X-Ma-Dieu-Khien lấy từ vé chủ phòng. Mỗi phòng chỉ ghi được một bản tại một thời điểm.

curl -X POST https://meet.axisdev.vn/api/phong/kmt-pdrs-nhq/ghi-hinh \
  -H "X-Ma-Dieu-Khien: $MA_DIEU_KHIEN"

Cũng cần X-Ma-Dieu-Khien. Sau khi dừng, file mất khoảng vài chục giây để xử lý xong, rồi tải về được trong trang quản trị.

{
  "thanhCong": true,
  "duLieu": {
    "tongSoPhong": 128,
    "phongDangMo": 12,
    "soLuotThamGia": 940,
    "soNguoiKhacNhau": 86,
    "soPhutNguoi": 41230,
    "phongDungNhieuNhat": [ { "maPhong": "...", "soPhutNguoi": 1840 } ],
    "hanMuc": { "soPhongDongThoi": 2, "soNguoiMoiPhong": 20 }
  }
}

soPhutNguoi là tổng số phút của tất cả người tham gia cộng lại — dùng để đối chiếu giờ dạy hoặc chia chi phí nội bộ giữa các bộ phận.