---
sourceType: official-guide
sourceTypeMatchedRule: fallback
slug: BOT/call_api
title: Sử dụng API
---
Để gửi yêu cầu đến hệ thống Open APIs của Zalo Bot, bạn sử dụng Bot Token đã được cấp và làm theo hướng dẫn bên dưới.

### Định dạng URL

Tất cả các truy vấn đến Zalo Bot API **phải được thực hiện qua giao thức HTTPS** và có định dạng như sau:

```js
https://bot-api.zaloplatforms.com/bot<BOT_TOKEN>/<functionName>
```

**Ví dụ**:

```
https://bot-api.zaloplatforms.com/bot123456789:abc123xyz/getMe
```

---

### Phương thức HTTP hỗ trợ

- `GET`  
- `POST`

---

### Cách truyền tham số

Zalo Bot hỗ trợ cả 2 phương thức HTTP GET và POST cho tất cả các API, với các cách để truyền tham số như sau:

* **Chuỗi truy vấn URL (query string)**  
Ví dụ:  `...?chat_id=123456&text=Hello`

* **`application/x-www-form-urlencoded`**  
Dạng form tiêu chuẩn (dùng với POST đơn giản)

* **`application/json`**  
Gửi payload dạng JSON-object

* **`multipart/form-data`**  
Dùng khi cần **tải lên file** như ảnh, tài liệu,...

Tuy nhiên, bạn nên cân nhắc sử dụng phương thức **HTTP GET** cho các API dùng để **truy xuất dữ liệu** và **POST** cho các API **dùng để thay đổi** (ghi/cập nhật) thông tin dữ liệu.

---

### Phản hồi từ API

Phản hồi từ Zalo Bot API luôn là dạng **JSON-object**, gồm các trường thông tin chính sau:

| Trường        | Ý nghĩa |
|---------------|--------|
| `ok`          | `true` nếu thành công, `false` nếu có lỗi |
| `result`      | Dữ liệu trả về nếu thành công |
| `description` | Mô tả lỗi ngắn gọn (nếu có) |
| `error_code`  | Mã lỗi hệ thống |
---

### Lưu ý

- Tất cả truy vấn gửi đến Zalo Bot API phải sử dụng encoding **UTF-8**.
- Các tên **API (method name)** có phân biệt chữ hoa và chữ thường.