API Miracle Network
REST API cho automation bên ngoài — token, scope và best practice.
API Miracle Network
API cho phép hệ thống bên ngoài đọc/ghi tài nguyên được phép: trigger workflow, query trạng thái, quản lý metadata (theo role).
Xác thực
- API key hoặc OAuth workspace — tạo trong Settings, scope tối thiểu.
- Rotate key định kỳ; revoke ngay khi nhân viên nghỉ.
Pattern phổ biến
POST /api/.../workflows/{id}/execute
GET /api/.../executions/{id}
Chi tiết endpoint theo version API trong developer portal nội bộ (sau đăng nhập) hoặc tài liệu sales engineer.
Best practice
- Idempotency key cho request đặt lệnh / tạo đơn.
- Pagination khi list lớn.
- Không embed key trong mobile app client-side.