API Reference

Quick Reference
Base URL: https://insights.omisell.com
Auth: Authorization: Omi <jwt_token>
Format: JSON
API Version: v1

Authentication

Mọi request cần header:

Authorization: Omi <jwt_token>

Token JWT được lấy từ parent app (oms.boxme.asia) qua localStorage, cookie, hoặc URL param.

WARNING

Không dùng "Bearer" prefix. Hệ thống dùng custom scheme "Omi".

Source: (src/app/core/interceptors/auth.interceptor.ts:10-20)

Resource	Endpoints	Base Path	Auth	Tài liệu
AI Chat	1	`/api/v1/ai/chat`	Yes	Xem
Insights	5	`/api/v1/insights/`	Yes	Xem
Dashboards	13	`/api/v1/dashboards/`	Yes	Xem
Notifications	9	`/api/v1/notifications/`	Yes	Xem
AI Connectors	4	`/api/v1/ai/connectors`	Yes	Xem

Tổng cộng: 32 endpoints

Source: (src/app/core/services/api.service.ts:1-274)

Code	Tên	Mô tả	Xử lý Frontend
200	OK	Thành công	Parse response body
401	Unauthorized	Token hết hạn/sai	Logout + redirect login
403	Forbidden	Không có quyền	Log + thông báo
422	Unprocessable	Validation error	Hiện lỗi từ response
500	Server Error	Lỗi backend	Log + thông báo chung

Source: (src/app/core/interceptors/error.interceptor.ts:1-48)

Khi environment.demoMode = true, tất cả API calls được intercept bởi DemoInterceptor và trả mock data. Không có request nào tới backend thật.

Simulated delays:

Source: (src/app/core/interceptors/demo.interceptor.ts:1-256)