# Using the docs with AI

Every page on developers.tino.vn has a Markdown version with the same content as the HTML page. Coding agents and LLMs read the Markdown version (fewer tokens, no JavaScript needed) instead of the HTML; the HTML page declares it with `<link rel="alternate" type="text/markdown">`.

Updated: 2026-10-21.

## Machine-readable paths

| Path | Content |
| --- | --- |
| `https://developers.tino.vn/en/llms.txt` | Index following the llmstxt.org standard: every page, one Markdown link per line with a summary |
| `https://developers.tino.vn/en/llms-full.txt` | All documentation in one Markdown file (context bundle) |
| Page path + `.md` | The Markdown version of a page, for example `/en/docs/oauth.md`, `/en/docs/api/get-details.md` |
| `https://developers.tino.vn/en/openapi.json` | OpenAPI 3.1 of the `/v1` gateway: every route, scope, parameters, sample responses where available |

On every page, the **Copy Markdown** button copies the page's Markdown version, and **View .md** opens it. Route pages also have **Copy context**: the route page together with the [Calling the Tino API](/en/docs/api) page (authentication, how to send parameters, error codes) in one copy.

## For coding agents

Paste this into your prompt, or into the project's instruction file (`AGENTS.md`, `CLAUDE.md`…):

```text
Tino API docs: read https://developers.tino.vn/en/llms.txt, then the .md version of the pages you need (add .md to the page path).
Call the Tino API through https://api.tino.vn/v1/<route> with the header Authorization: Bearer <token>. Each route needs a scope;
a route outside the token's scopes returns 403 insufficient_scope. Do not write the token into source code: read it from the TINO_TOKEN environment variable.
```

Client generators (OpenAPI Generator, openapi-typescript…) read `https://developers.tino.vn/en/openapi.json`. Truncated sample responses (`… N more item(s)`) are not attached as `example` in OpenAPI; see the fuller version on the route page.

## AI assistants working with a Tino account

Reading the docs is different from acting on an account. To let Claude or ChatGPT view and manage the customer's services, domains, DNS and invoices within the scopes the customer approved, use the MCP server `https://api.tino.vn/mcp`: see [Connect Claude, ChatGPT to Tino (MCP)](/en/docs/mcp).