# Tổng quan API

> GHN API cung cấp các khối chức năng để tạo đơn, tính phí, đồng bộ địa chỉ, nhận webhook và quản lý yêu cầu hỗ trợ. Tất cả phản hồi sử dụng JSON và mã trạng thái nhất quán.

## Bắt đầu nhanh

Thực hiện lần lượt ba bước sau để xác thực, tạo đơn thử và nhận trạng thái đơn.

1. **Xác thực** — Gửi `Token` và `ShopId` trong header của yêu cầu. [Mở hướng dẫn](https://developer.ghn.vn/vi/docs/token/get-token.md)
2. **Tạo đơn** — Gửi địa chỉ, kiện hàng và lựa chọn dịch vụ. [Mở endpoint](https://developer.ghn.vn/vi/docs/order/create.md)
3. **Nhận webhook** — Đồng bộ trạng thái đơn theo thời gian thực. [Mở hướng dẫn](https://developer.ghn.vn/vi/docs/webhook/callback-order-status.md)

## Môi trường API

Phát triển và kiểm thử ở môi trường riêng trước khi chuyển sang vận hành thực tế.

| Môi trường | URL |
| --- | --- |
| Production | `https://online-gateway.ghn.vn` |
| Staging | `https://dev-online-gateway.ghn.vn` |

## Quy ước chung

- Gửi và nhận dữ liệu dưới định dạng `application/json`.
- Thời gian dùng ISO 8601 và múi giờ Việt Nam khi có thể.
- Số tiền dùng đồng; khối lượng dùng gram; kích thước dùng centimet.
- Không ghi `Token` vào log, URL hoặc mã nguồn phía client.