VietDDNS
API

Tài liệu API

API công khai hiện tại chỉ hỗ trợ HTTPS Update với endpoint /update.

Base URL

https://api.vietddns.net

HTTPS Update

Method: GET

Path: /update

Auth: Query token (token)

Query Parameters

Tên Bắt buộc Mô tả
hostname Có Hostname/subdomain bắt buộc thuộc tài khoản của bạn, ví dụ myhome hoặc myhome.vietddns.net.
token Có API token cấp cho người dùng.
ip Không IPv4 muốn cập nhật. Nếu bỏ qua, backend dùng IP nguồn.

Phản hồi thành công

{ "result": "good", "hostname": "myhome", "fqdn": "myhome.vietddns.net", "ip": "1.2.3.4" }

Mã phản hồi thường gặp

HTTP Body JSON Ý nghĩa
200 {"result":"good"|"nochg", ...} Cập nhật thành công hoặc IP không đổi.
400 {"error":"..."} Thiếu tham số hoặc IP không hợp lệ.
401 {"error":"Token không hợp lệ"} Token không hợp lệ.
404 {"error":"..."} Hostname không tồn tại hoặc không thuộc tài khoản.
500 {"error":"..."} Lỗi xử lý nội bộ.

Ví dụ

curl 'https://api.vietddns.net/update?hostname=myhome&token=YOUR_API_TOKEN&ip=1.2.3.4'

Lưu ý