REST API & webhook Early Adopter
REST API và webhook có sẵn trên gói Early Adopter trở lên. Xem Gói & thanh toán.
Đưa các cuộc họp của bạn vào phần còn lại của hệ thống công nghệ. Lấy ghi chú có cấu trúc và bản phiên âm bằng REST API, và nhận webhook ngay khi một ghi chú sẵn sàng — tự động đẩy tới Slack, một CRM, hoặc một kho dữ liệu.
Xác thực
- Trong ứng dụng web, mở Cài đặt → Nhà phát triển.
- Tạo một API token cho nhóm.
- Gửi nó dưới dạng bearer token trong mỗi yêu cầu:
curl https://platform.scribx.app/api/v1/recordings \
-H "Authorization: Bearer YOUR_API_TOKEN"
Token được giới hạn phạm vi trong một nhóm và có thể bị thu hồi bất cứ lúc nào.
Bạn có thể lấy những gì
- Bản ghi — liệt kê và lấy các cuộc họp kèm siêu dữ liệu
- Bản phiên âm — toàn bộ các dòng có gắn nhãn người nói và dấu thời gian
- Tóm tắt — bản ghi chép có cấu trúc và hạng mục hành động
Duyệt toàn bộ lược đồ luôn được cập nhật trong tài liệu tham khảo API ngay trong ứng dụng (Swagger UI), được liên kết từ Cài đặt → Nhà phát triển.
Webhook
Đăng ký một URL webhook và ScribX sẽ POST tới nó khi có các sự kiện quan trọng — hữu ích nhất là khi ghi chú của một cuộc họp sẵn sàng:
- Trong Cài đặt → Nhà phát triển, thêm một điểm cuối webhook.
- Chọn các sự kiện cần đăng ký nhận.
- Điểm cuối của bạn nhận được một payload JSON với id bản ghi và loại sự kiện; lấy chi tiết qua API.
{
"event": "recording.note_ready",
"recording_id": "rec_…",
"team_id": "proj_…"
}
Hãy xác minh payload và phản hồi 2xx nhanh chóng, rồi xử lý phần nặng một cách bất đồng bộ — ScribX sẽ thử lại khi nhận phản hồi không phải 2xx.