# Tra whois tên miền

`GET /whois/@domain` · công khai, không cần token

Tra whois một tên miền, không cần token (gọi thẳng `https://api.tino.vn`, không qua gateway `/v1`). Luôn trả HTTP 200 với `success: true`; đọc kết quả theo thứ tự:

- Có `error` (vd `incorrect_tld`: đuôi không hợp lệ hoặc không tra được): bỏ qua `available`, câu trả lời vẫn ghi `available: true`.
- `raw` là `Rate limit exceeded`: tra quá nhanh; `available: false` lúc này không có nghĩa tên miền đã có chủ. Chờ rồi tra lại.
- `domain` là một đuôi Tino đang bán (vd `vn`): chỉ có `success`, `domain`, `available: false`.
- `available: true`, `status: ok`, `whois: []`: không thấy dữ liệu whois của tên miền (`raw` là văn bản gốc hoặc `Domain not found`).
- `available: false`, `whois` là object: tên miền đã có chủ. Trường có mặt khi registry trả: `domain`, `registrar`, `createDate`, `expiredDate`, `updatedDate`, `registrantName`, `registrantOrg`, `nameservers`, `Dnssec`, `status`, `WhoisServer`, `DomainReserved`. Ngày giữ nguyên dạng registry trả (vd `+07:00` với `.vn`, `Z` với `.com`).

`raw` là văn bản whois gốc: xuống dòng bằng `<br />`, ký tự đặc biệt đã mã hoá HTML.

## HTTP request

| Mục | Giá trị |
| --- | --- |
| URL | `https://api.tino.vn/whois/@domain` |
| Method | `GET` |
| Xác thực | không cần token: gọi thẳng `https://api.tino.vn`, không qua gateway `/v1` |
| Content-Type | — (không có body) |

## Tham số

| Tên | Vị trí | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- | --- |
| `domain` | đường dẫn | string | có | Tên miền cần tra (vd `tino.vn`), hoặc một đuôi (vd `vn`) |

## Example request

```bash
curl "https://api.tino.vn/whois/tino.vn"
```

Route công khai: ví dụ không gửi token. Tham số đường dẫn trong ví dụ là giá trị mẫu.

SDK ([SDK & Ví dụ](/docs/sdk)): Python `client.domains.whois(domain)`, Node.js `await client.domains.whois(domain);`, PHP `$client->domains->whois($domain);`.

## Example response

```json
{
 "success": true,
 "domain": "tino.vn",
 "available": false,
 "status": "",
 "whois": {
  "domain": "tino.vn",
  "registrar": "Công ty Cổ phần Tập đoàn Tino",
  "createDate": "2022-02-02T16:32:35+07:00",
  "expiredDate": "2035-02-02T16:32:35+07:00",
  "registrantName": "CÔNG TY CỔ PHẦN TẬP ĐOÀN TINO",
  "nameservers": [
   "ns1.tino.vn",
   "ns2.tino.vn"
  ],
  "Dnssec": "unsigned",
  "status": [
   "clientDeleteProhibited",
   "clientTransferProhibited",
   "serverUpdateProhibited",
   "serverDeleteProhibited",
   "serverTransferProhibited"
  ]
 },
 "raw": "Dnssec: unsigned<br />Domain Name: tino.vn<br />Registry Expiry Date: 2035-02-02T16:32:35+07:00<br />…"
}
```

Mẫu thật gọi ngày 26/10/2026 với tên miền của Tino; `raw` được rút gọn.