# Thêm bản ghi DNS

`POST /v1/service/@service_id/dns/@zone_id/records` · quyền `dns:write`

Thêm một bản ghi vào vùng DNS.

## HTTP request

| Mục | Giá trị |
| --- | --- |
| URL | `https://api.tino.vn/v1/service/@service_id/dns/@zone_id/records` |
| Method | `POST` |
| Quyền (scope) | `dns:write` |
| Header | `Authorization: Bearer <token>` |
| Content-Type | `application/json` |
| Token gọi được | token ứng dụng (`tinoat_`), token API cá nhân (`tinopat_`) |

## Tham số

| Tên | Vị trí | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- | --- |
| `service_id` | đường dẫn | string | có | ID dịch vụ DNS |
| `zone_id` | đường dẫn | string | có | ID vùng DNS |
| `name` | body | string | không | Record name |
| `ttl` | body | integer | không | Record ttl |
| `priority` | body | integer | không | Priority of the record |
| `type` | body | string | không | Record type |
| `content` | body | string | không | Contents of the record |

## Example request

```bash
curl -X POST "https://api.tino.vn/v1/service/100003/dns/500001/records" \
  -H "Authorization: Bearer $TINO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "example.com",
  "ttl": 3600,
  "priority": 10,
  "type": "A",
  "content": "203.0.113.10"
}'
```

`$TINO_TOKEN` là token có quyền `dns:write`. Tham số đường dẫn trong ví dụ là giá trị mẫu.

SDK ([SDK & Ví dụ](/docs/sdk)): Python `client.dns.create_record(service_id, zone_id, service_id=...)`, Node.js `await client.dns.createRecord(serviceId, zoneId, { service_id: ... });`, PHP `$client->dns->createRecord($serviceId, $zoneId, ['service_id' => ...]);`.

## Example response

```json
{
 "success": true,
 "record": {
  "name": "tino-sdk-capture",
  "type": "TXT",
  "ttl": 3600,
  "priority": 0,
  "content": "<redacted>"
 },
 "info": [
  [
   "dnsnewrecordadded",
   "TXT"
  ]
 ]
}
```

Mẫu thật từ tài khoản thử, đã che dữ liệu cá nhân; mảng và chuỗi dài được rút gọn (`… N more item(s)`, `… N more line(s)`).