# Môi trường thử nghiệm

Tino chưa có môi trường thử nghiệm (sandbox) riêng cho API: mọi route chạy trên tài khoản, dịch vụ và tiền thật của khách. Trang này là cách thử an toàn trong điều kiện đó.

Cập nhật: 2026-10-21.

## Thử với token chỉ có quyền đọc

Khi khám phá API, tạo [token API cá nhân](/docs/personal-tokens) chỉ gồm các quyền `…:read` cần dùng, hạn 30 ngày, giới hạn IP của máy đang thử. Route ghi khi đó trả 403 `insufficient_scope` thay vì làm thay đổi thật.

```bash
curl https://api.tino.vn/v1/service -H "Authorization: Bearer $TINO_TOKEN"
```

Thu hồi token ngay khi thử xong, ở `https://auth.tino.vn/me/security`.

## Route ghi tác động thật

| Thao tác | Hệ quả thật |
| --- | --- |
| Đặt mua, gia hạn tên miền, dịch vụ, chứng chỉ SSL | tạo đơn và hoá đơn |
| Thanh toán bằng số dư, trả hoá đơn bằng số dư | trừ tiền trong tài khoản |
| Nạp tiền | tạo hoá đơn nạp tiền |
| Đổi nameserver, sửa, xoá bản ghi DNS | website, email của tên miền đổi theo sau khi DNS lan truyền |
| Bật, tắt, khởi động lại, reset VPS | dịch vụ trên VPS gián đoạn |
| Tạo, trả lời ticket | nhân viên Tino nhận và xử lý |

Thử thao tác DNS trên một tên miền hoặc vùng không dùng cho website thật, hoặc dùng bản ghi `TXT` có tên riêng rồi xoá đi.

## Xem trước khi làm

- `GET /v1/service/@id/methods`: các thao tác dịch vụ hỗ trợ, trước khi gọi.
- `POST /v1/service/@id/upgrade` không kèm `send=true`: chỉ tính giá nâng cấp, chưa gửi yêu cầu.
- `POST /v1/domain/lookup`: kiểm tra tên miền còn trống và giá, trước khi đặt mua.

## Chạy test không chạm tài khoản thật

Dựng mock server từ [OpenAPI](/openapi.json) (ví dụ bằng Prism hoặc công cụ OpenAPI khác): các route có mẫu response trọn vẹn được gắn làm `example`. Test của ứng dụng gọi mock; chỉ bước kiểm tra cuối mới gọi API thật với token quyền đọc.

## Trợ lý AI qua MCP

Khi nối Claude, ChatGPT với Tino qua [MCP](/docs/mcp), giữ chế độ hỏi trước khi chạy thao tác ghi và đọc kỹ nội dung trước khi đồng ý.