# Kiểm token bot

`POST /service/@id/tinopay/notification-apps/bot-info` · TinoPay, token đăng nhập của chủ dịch vụ

Bước 1 khi thêm ứng dụng thông báo dùng bot riêng: `type` (`telegram`, `zalo`) và `bot_token` vừa nhập, hoặc `app_id` để dùng token đang lưu của ứng dụng đó (khi sửa). Trả `{valid, bot_name, error}`: `valid` là `false` thì hiện `error`. Xem [Thông báo Telegram, Zalo, Lark](/docs/tinopay-notifications).

## HTTP request

| Mục | Giá trị |
| --- | --- |
| URL | `https://api.tino.vn/service/@id/tinopay/notification-apps/bot-info` |
| Method | `POST` |
| Xác thực | token đăng nhập của chủ dịch vụ TinoPay (`Authorization: Bearer <token>`); gateway `/v1` chưa mở TinoPay |
| Content-Type | `application/json` |

## Tham số

| Tên | Vị trí | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- | --- |
| `id` | đường dẫn | int | có | ID dịch vụ TinoPay |
| `type` | body | string | — | telegram \| zalo |
| `bot_token` | body | string | — | — |
| `app_id` | body | int | — | — |

## Example request

```bash
curl -X POST "https://api.tino.vn/service/100001/tinopay/notification-apps/bot-info" \
  -H "Authorization: Bearer $TINO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "zalo",
  "bot_token": "<bot_token>"
}'
```

`$TINO_TOKEN` là token đăng nhập của chủ dịch vụ TinoPay. Tham số đường dẫn trong ví dụ là giá trị mẫu.

SDK ([SDK & Ví dụ](/docs/sdk)): chưa có hàm riêng, dùng `client.request("POST", "/service/@id/tinopay/notification-apps/bot-info")`.

## Example response

```json
{
 "data": {
  "valid": true,
  "bot_name": "Bot Cửa hàng ABC",
  "error": null
 }
}
```

Mẫu dựng theo tài liệu TinoPay API v1 (Tino chuyển tiếp nguyên dữ liệu TinoPay), giá trị là ví dụ.