# Kiểm tra lại DNS

`POST /service/@id/builder/sites/@site/domains/@hostname/verify` · TinoPage Builder, token đăng nhập của chủ dịch vụ

Kiểm bản ghi DNS của tên miền ngay (tối đa khoảng 12 giây) và trả tên miền sau khi kiểm. Đủ CNAME và TXT thì `status` chuyển `active` và HTTPS được cấp tự động; chưa đủ thì `error` nói thiếu gì. Tên miền `pending` cũng được TinoPage Builder tự kiểm lại theo lịch (`next_check_at`).

## HTTP request

| Mục | Giá trị |
| --- | --- |
| URL | `https://api.tino.vn/service/@id/builder/sites/@site/domains/@hostname/verify` |
| Method | `POST` |
| Xác thực | token đăng nhập của chủ dịch vụ TinoPage Builder (`Authorization: Bearer <token>`); gateway `/v1` chưa mở TinoPage Builder |
| 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ụ TinoPage Builder |
| `site` | đường dẫn | string | có | ID website (UUID, `id` ở danh sách website) |
| `hostname` | đường dẫn | string | có | Tên miền riêng, chữ thường (`hostname` ở danh sách tên miền) |
| `idempotency_key` | body | string | không | 8–64 ký tự `A-Za-z0-9._:-`: gửi lại cùng khoá và cùng nội dung thì nhận lại kết quả lần trước, không làm lại |

## Example request

```bash
curl -X POST "https://api.tino.vn/service/100003/builder/sites/5b1e2c3d-4f5a-4b6c-8d7e-9f0a1b2c3d4e/domains/banhang.example.vn/verify" \
  -H "Authorization: Bearer $TINO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "idempotency_key": "kiem-dns-0001"
}'
```

`$TINO_TOKEN` là token đăng nhập của chủ dịch vụ TinoPage Builder. 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/builder/sites/@site/domains/@hostname/verify")`.

## Example response

```json
{
 "data": {
  "hostname": "banhang.example.vn",
  "status": "pending",
  "ssl_status": "pending",
  "txt_ok": false,
  "cname_ok": false,
  "dns": [
   {
    "type": "CNAME",
    "name": "banhang",
    "value": "dns.tino.page"
   },
   {
    "type": "TXT",
    "name": "_tino-verify.banhang",
    "value": "tino-site-verify=4b6d0e2a7c914f3e8a5b1c2d9e0f7a6b"
   }
  ],
  "error": "thiếu bản ghi TXT _tino-verify; CNAME chưa trỏ về dns.tino.page",
  "checked_at": "2026-10-26T03:30:00Z",
  "url": "https://banhang.example.vn",
  "owner_verified": false,
  "check_count": 1,
  "next_check_at": "2026-10-26T03:35:00Z"
 }
}
```

Mẫu dựng theo API của TinoPage Builder (Tino chuyển tiếp nguyên câu trả lời trong `data`), giá trị là ví dụ.