> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.omicx.one/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.omicx.one/_mcp/server.

# Tổng quan

OMICX Public API cho phép các đối tác bên thứ ba tích hợp trực tiếp với
nền tảng OMICX qua HTTP, gồm 5 nhóm năng lực:

| Nhóm           | Dùng để                                                                                                             | Xem chi tiết                                                     |
| -------------- | ------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| **Khách hàng** | Tạo, tra cứu, tìm kiếm, cập nhật khách hàng CRM; ghi chú, chuyển phụ trách, gán người liên quan, quy trình chăm sóc | [Khách hàng](/customers/info/create-customer)                    |
| **Đánh giá**   | Tạo link đánh giá theo bản mẫu, tra cứu kết quả, và endpoint để khách hàng tự điền                                  | [Đánh giá](/feedbacks/manage/issue-feedback-token)               |
| **Cấu hình**   | Danh mục tham chiếu dùng kèm Khách hàng — thuộc tính, tiêu chí AI Insights, Tag, Nhóm, nhân viên, quy trình         | [Cấu hình](/customer-config/attributes/list-customer-attributes) |
| **Tích hợp**   | Speech to Text, Text to Speech, và Webhook nhận sự kiện bất đồng bộ                                                 | [Tích hợp](/integrations/speech-to-text/transcribe-speech)       |
| **Hệ thống**   | Health check                                                                                                        | [Hệ thống](/system/health-check)                                 |

## Xác thực

Tất cả endpoint (trừ `GET /health`) đều yêu cầu header `X-Api-Key` — xem
chi tiết tại trang [API Keys](/authentication).

## Base URL

`https://api.omicx.one` cho toàn bộ endpoint, **trừ** health check dùng
base URL riêng — xem [Health Check](/system/health-check). Luôn dùng
HTTPS, không gửi API key qua HTTP thường.

## Đồng bộ và bất đồng bộ

* **Khách hàng, Đánh giá, Speech to Text, Text to Speech, Cấu hình** xử
  lý **đồng bộ (synchronous)** — kết quả trả về ngay trong response
  HTTP, không cần polling.
* **Webhook** hoạt động theo chiều ngược lại: bạn đăng ký một endpoint
  HTTP của mình để **nhận** sự kiện (ví dụ khi một job Speech to
  Text/Text to Speech hoàn tất) — xem [Webhook](/integrations/webhooks/list-webhooks)
  và [Callback Events](/integrations/callback-events/speech-to-text).

Riêng [Gửi câu trả lời đánh giá](/feedbacks/manage/submit-feedback)
trong nhóm **Đánh giá** không cần `X-Api-Key` — đây là endpoint để
trang do chính khách hàng của bạn mở, xác thực bằng token lấy từ link.

## Content-Type theo từng endpoint

| Endpoint                                                             | Content-Type           |
| -------------------------------------------------------------------- | ---------------------- |
| `POST /customers`, `PATCH /customers`, `POST /customers/search`, ... | `application/json`     |
| `POST /tts`                                                          | `application/json`     |
| `POST /stt`                                                          | `multipart/form-data`  |
| `GET /health`                                                        | — (không cần xác thực) |