# DANIX Open API

> Tài liệu tiếng Việt cho nhà phát triển: gọi API của shop trên DANIX bằng khoá `dnx_live_…`, và nhận dữ liệu qua luồng tự động (webhook). Địa chỉ gốc của API: https://danix.vn/api/open/v1.

## Cách agent nên dùng

- Xác thực bằng header `Authorization: Bearer dnx_live_…`; không bao giờ đặt khoá trong URL và không in khoá ra log.
- Mọi danh sách phân trang bằng con trỏ: lặp lại với `cursor` lấy từ `nextCursor` cho tới khi `nextCursor` là null.
- Gửi `Idempotency-Key` khi tạo đơn, tạo khách hay gửi tin nhắn để gọi lại không tạo trùng.
- Gặp 429 thì chờ theo `Retry-After`; gặp 5xx thì thử lại có giãn cách.
- Luôn xác minh chữ ký webhook (Standard Webhooks) trên thân thô trước khi xử lý, và khử trùng theo `webhook-id`.
- Bỏ qua trường và giá trị enum lạ trong phản hồi: API được phép thêm chúng mà không đổi phiên bản.

## Hướng dẫn

- [Tổng quan và bắt đầu nhanh](https://danix.vn/developers.md): Open API của DANIX: tạo ứng dụng kết nối, gọi thử bằng curl và tạo luồng tự động đầu tiên.
- [Xác thực](https://danix.vn/developers/authentication.md): Khoá API dnx_live_, quyền, trang chat được chọn, xoay khoá, thu hồi và giữ khoá an toàn.
- [Lỗi](https://danix.vn/developers/errors.md): Định dạng lỗi RFC 9457 và bảng mọi mã code kèm cách xử lý.
- [Hạn mức gọi](https://danix.vn/developers/rate-limits.md): Hạn mức theo khoá, header X-RateLimit và cách thử lại khi gặp 429.
- [Phân trang và đồng bộ](https://danix.vn/developers/pagination.md): Con trỏ phân trang, updatedSince, độ trễ an toàn và dòng đã xoá.
- [Idempotency-Key](https://danix.vn/developers/idempotency.md): Gọi lại an toàn khi tạo đơn, tạo khách và gửi tin nhắn.
- [Luồng tự động và webhook](https://danix.vn/developers/webhooks.md): Luồng tự động gửi dữ liệu tới hệ thống của bạn: chữ ký Standard Webhooks, mã kiểm chữ ký, thử lại và chống trùng.
- [Cách luồng chạy (cho người quen n8n)](https://danix.vn/developers/flow-logic.md): Thứ tự chạy, mục, Gộp, Gom, Khi lỗi, Chạy một lần, Gửi lại và những chỗ khác n8n.
- [Sự kiện](https://danix.vn/developers/events.md): Danh mục sự kiện, cấu trúc envelope, trường changes và ví dụ từng loại.
- [Phiên bản](https://danix.vn/developers/versioning.md): Phiên bản /v1, thay đổi không phá vỡ và cách viết client chịu được thay đổi.

## Tham chiếu API

- [Tham chiếu: Shop](https://danix.vn/developers/reference/shop.md): Thông tin shop mà khoá API đang thuộc về.
- [Tham chiếu: Đơn hàng](https://danix.vn/developers/reference/orders.md): Danh sách, chi tiết, tạo, sửa, đổi trạng thái và ghi chú của đơn hàng.
- [Tham chiếu: Sản phẩm](https://danix.vn/developers/reference/products.md): Sản phẩm, mẫu mã và danh mục.
- [Tham chiếu: Kho](https://danix.vn/developers/reference/inventory.md): Kho, tồn kho và phiếu nhập, xuất, kiểm kho.
- [Tham chiếu: Khách hàng](https://danix.vn/developers/reference/customers.md): Khách hàng, địa chỉ và ghi chú.
- [Tham chiếu: Địa giới hành chính](https://danix.vn/developers/reference/geo.md): Danh mục tỉnh, huyện, xã để lấy mã đơn vị cho địa chỉ giao hàng.
- [Tham chiếu: Vận đơn](https://danix.vn/developers/reference/shipments.md): Vận đơn, hành trình và huỷ vận đơn.
- [Tham chiếu: Hội thoại](https://danix.vn/developers/reference/chat.md): Trang chat, hội thoại, tin nhắn, thẻ và bình luận.

## Đặc tả

- [openapi.json](https://danix.vn/openapi.json): đặc tả OpenAPI 3.0 của toàn bộ API công khai.

## Optional

- [llms-full.txt](https://danix.vn/llms-full.txt): toàn bộ tài liệu trong một tệp Markdown.