# Dùng tài liệu với AI

Mọi trang trên developers.tino.vn có bản Markdown cùng nội dung với trang HTML. Coding agent và LLM đọc bản Markdown (ít token, không cần chạy JavaScript) thay vì HTML; trang HTML khai bản này bằng `<link rel="alternate" type="text/markdown">`.

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

## Đường dẫn cho máy đọc

| Đường dẫn | Nội dung |
| --- | --- |
| `https://developers.tino.vn/llms.txt` | Mục lục theo chuẩn llmstxt.org: mọi trang, mỗi dòng một link Markdown kèm tóm tắt |
| `https://developers.tino.vn/llms-full.txt` | Toàn bộ tài liệu trong một file Markdown (gói ngữ cảnh) |
| Đường dẫn trang + `.md` | Bản Markdown của một trang, ví dụ `/docs/oauth.md`, `/docs/api/get-details.md` |
| `https://developers.tino.vn/openapi.json` | OpenAPI 3.1 của gateway `/v1`: mọi route, quyền (scope), tham số, mẫu response khi có |

Trên mỗi trang: nút **Sao chép Markdown** chép bản Markdown của trang, **Xem .md** mở bản đó. Trang route có thêm **Sao chép ngữ cảnh**: trang route cùng trang [Gọi API Tino](/docs/api) (xác thực, cách gửi tham số, mã lỗi) trong một lần chép.

## Cho coding agent

Dán vào yêu cầu, hoặc vào file hướng dẫn của dự án (`AGENTS.md`, `CLAUDE.md`…):

```text
Tài liệu API Tino: đọc https://developers.tino.vn/llms.txt, rồi bản .md của các trang cần dùng (thêm .md vào đường dẫn trang).
Gọi API Tino qua https://api.tino.vn/v1/<route> với header Authorization: Bearer <token>. Mỗi route cần một quyền (scope);
route ngoài quyền của token trả 403 insufficient_scope. Không ghi token vào mã nguồn: đọc từ biến môi trường TINO_TOKEN.
```

Máy sinh client (OpenAPI Generator, openapi-typescript…) đọc `https://developers.tino.vn/openapi.json`. Mẫu response bị rút gọn (`… N more item(s)`) không gắn làm `example` trong OpenAPI; xem bản đầy đủ hơn trên trang route.

## Trợ lý AI làm việc với tài khoản Tino

Đọc tài liệu khác với thao tác trên tài khoản. Để Claude, ChatGPT xem và quản lý dịch vụ, tên miền, DNS, hoá đơn của khách trong phạm vi quyền khách đồng ý, dùng máy chủ MCP `https://api.tino.vn/mcp`: xem [Kết nối Claude, ChatGPT với Tino (MCP)](/docs/mcp).