# Đăng website

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

Đăng bản mới nhất của website, cũng là mở lại website đã tạm ngưng. Trả website. Website bị hệ thống tạm ngưng vì tài khoản vượt số website trả 409 `SITE_PAUSED`: xoá bớt website khác hoặc nâng số website của dịch vụ.

## HTTP request

| Mục | Giá trị |
| --- | --- |
| URL | `https://api.tino.vn/service/@id/builder/sites/@site/publish` |
| 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) |
| `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/publish" \
  -H "Authorization: Bearer $TINO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "idempotency_key": "dang-website-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/publish")`.

## Example response

```json
{
 "data": {
  "id": "5b1e2c3d-4f5a-4b6c-8d7e-9f0a1b2c3d4e",
  "name": "Tiệm bánh Hoa Mai",
  "slug": "tiem-banh-hoa-mai",
  "status": "published",
  "paused": false,
  "paused_reason": null,
  "host": "example.vn",
  "preview_url": "https://builder.tino.vn/tiem-banh-hoa-mai",
  "pages": {
   "used": 3,
   "limit": 10
  },
  "items": {
   "used": 12,
   "limit": 100
  },
  "domains": {
   "used": 1,
   "limit": 2
  },
  "created_at": "2026-10-26T02:10:00Z",
  "updated_at": "2026-10-26T03:20: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ụ.