Câu hỏi thường gặp về API

Các câu hỏi thường gặp về NiceNIC API tên miền v2

Tìm câu trả lời thiết thực về quyền truy cập API, kiểm thử trên môi trường thử nghiệm, xác thực, bảng giá, thao tác tên miền, xử lý phản hồi và tích hợp vào môi trường thực tế.

28 câu hỏi có sẵn

Bắt đầu

Bắt đầu với quyền truy cập, bảng giá và thông tin xác thực.

6 câu hỏi
01 API tên miền NiceNIC v2 là gì?

API tên miền NiceNIC v2 là API dựa trên HTTPS và JSON để tự động hóa quản lý tên miền thông qua tài khoản NiceNIC của bạn.

Hỗ trợ các quy trình nghiệp vụ chính, bao gồm kiểm tra tình trạng sẵn có của tên miền, đăng ký, gia hạn, chuyển nhượng, truy vấn danh mục, cập nhật máy chủ tên và thông tin liên hệ, giá, bản ghi DNS, máy chủ tên con, thông tin tài khoản và các thao tác liên quan đến tuân thủ.

Hãy sử dụng API khi bạn muốn kết nối trực tiếp các dịch vụ tên miền NiceNIC với website, nền tảng hosting, hệ thống thanh toán, công cụ nội bộ hoặc ứng dụng khác.

02 Ai có thể sử dụng API tên miền NiceNIC v2?

Mọi tài khoản NiceNIC đang hoạt động đều có thể sử dụng API tên miền v2. Quyền truy cập API dành cho cả tài khoản thị trường và tài khoản đại lý.

Bạn không cần trở thành đại lý chỉ để có quyền truy cập API. Loại tài khoản vẫn ảnh hưởng đến giá: các thao tác API trả phí sử dụng mức giá được gán cho tài khoản NiceNIC gửi yêu cầu.

Mở Cài đặt API →

03 API tên miền NiceNIC v2 có miễn phí không?

Có. Bản thân việc truy cập API là miễn phí. Không có khoản phí riêng cho việc kích hoạt truy cập API hoặc gửi các yêu cầu API được hỗ trợ.

Các thao tác trả phí như đăng ký, gia hạn và chuyển nhượng tên miền được tính phí theo mức giá của tài khoản và các quy định tên miền hiện hành.

04 Tôi có cần tài khoản đại lý để sử dụng API không?

Không. Truy cập API và bảng giá đại lý được tách biệt.

Bạn có thể sử dụng API tên miền v2 với tài khoản thị trường thông thường của NiceNIC. Chỉ nâng cấp lên tài khoản đại lý khi bảng giá đại lý hoặc các lợi ích đại lý khác phù hợp với quy mô kinh doanh của bạn.

So sánh các gói đại lý →

05 API v2 khác gì so với API NiceNIC cũ?

API tên miền v2 sử dụng cấu trúc API NiceNIC hiện tại với các yêu cầu HTTPS, phản hồi JSON, xác thực dựa trên header và tài liệu được tổ chức theo từng quy trình thao tác với tên miền và tài khoản.

Nếu bạn duy trì một hệ thống tích hợp được xây dựng trên API NiceNIC cũ, hãy xem lại các tham số và cách xử lý phản hồi của API v2 trước khi di chuyển lưu lượng vận hành, thay vì cho rằng hai phiên bản có thể thay thế cho nhau.

06 Làm cách nào để lấy thông tin xác thực API của tôi?

Đăng nhập vào tài khoản NiceNIC của bạn và mở Cài đặt API. Các yêu cầu API v2 sử dụng tên người dùng NiceNIC và mã bí mật API của bạn để xác thực.

Mẹo bảo mật: Giữ mã bí mật API ở phía máy chủ. Không được để lộ mã này trong JavaScript phía trình duyệt, kho mã nguồn công khai, ứng dụng khách hoặc bất kỳ vị trí nào có thể truy cập công khai.

Mở Cài đặt API →

Môi trường thử nghiệm và xác thực

Kết nối an toàn và kiểm thử trước khi vận hành thực tế.

5 câu hỏi
07 API tên miền NiceNIC v2 có cung cấp môi trường thử nghiệm API không?

Có. NiceNIC cung cấp môi trường thử nghiệm API để các nhà phát triển kiểm thử tích hợp trước khi kết nối với API vận hành thực tế.

Sử dụng môi trường thử nghiệm để kiểm tra xác thực, định dạng yêu cầu, phân tích phản hồi, xử lý lỗi và quy trình làm việc của ứng dụng trước khi kích hoạt các thao tác tên miền trực tiếp cho khách hàng.

Mở môi trường thử nghiệm API →

08 Sự khác biệt giữa môi trường thử nghiệm và API vận hành thực tế là gì?

Môi trường thử nghiệm API dành cho việc phát triển và kiểm thử tích hợp. API vận hành thực tế được sử dụng cho các thao tác tên miền trực tiếp và các yêu cầu trả phí trên tài khoản NiceNIC của bạn.

Chúng tôi khuyên bạn nên kiểm tra xác thực, xử lý yêu cầu, xử lý phản hồi và logic lỗi trong môi trường thử nghiệm trước khi kích hoạt các hoạt động vận hành thực tế phục vụ khách hàng.

09 Xác thực API hoạt động như thế nào?

Gửi các yêu cầu API qua HTTPS và đưa tên người dùng NiceNIC cùng khóa bí mật API của bạn vào tiêu đề Authorization.

Host: api.nicenic.net
Authorization: username:api_secret
Content-Type: application/json

Nếu hạn chế IP được bật cho tài khoản của bạn, các yêu cầu cũng phải được gửi từ một IP máy chủ được ủy quyền.

Đọc phần Xác thực API →

10 API tên miền v2 sử dụng điểm cuối nào?

Điểm cuối cơ sở của API trong môi trường thực tế là:

https://api.nicenic.net/v2/

Các thao tác API được chọn bằng các tham số được quy định cho từng điểm cuối, chẳng hạn như category và action. Luôn tuân theo tài liệu dành riêng cho điểm cuối để biết các tham số bắt buộc và tùy chọn của một thao tác cụ thể.

11 API v2 sử dụng định dạng phản hồi và bảng mã ký tự nào?

Phản hồi của API v2 sử dụng JSON và các tham số của yêu cầu sử dụng UTF-8.

{
  "code": 0,
  "msg": "success",
  "data": {}
}

Ứng dụng của bạn nên kiểm tra code và msg được trả về thay vì cho rằng mọi phản hồi HTTP đều thể hiện một thao tác tên miền đã hoàn tất.

Thao tác tên miền và giá cả

Tìm hiểu các quy trình được hỗ trợ và hành vi mua hàng.

6 câu hỏi
12 Tôi có thể làm gì với API tên miền NiceNIC v2?

Thông qua các API hiện được tài liệu hóa, bạn có thể tự động hóa các quy trình làm việc như kiểm tra tình trạng khả dụng của tên miền, đăng ký, gia hạn và chuyển nhượng, liệt kê danh mục và xem chi tiết tên miền, cập nhật máy chủ tên và thông tin liên hệ tên miền, định giá tên miền, bản ghi DNS, máy chủ tên con, thông tin tài khoản và giám sát lạm dụng và tuân thủ.

Các quy trình làm việc bổ sung được mô tả riêng trong phần điều hướng API.

13 Tôi nên kiểm tra gì trước khi kích hoạt đăng ký hoặc chuyển nhượng thực tế?

Bắt đầu với các thao tác chỉ đọc có mức rủi ro thấp như kiểm tra tình trạng khả dụng của tên miền, định giá tên miền, số dư tài khoản và danh sách tên miền.

Sau đó, hãy xác nhận các bước xác thực, phân tích phản hồi, xử lý lỗi và xử lý đơn hàng đang chờ trước khi kích hoạt đăng ký, gia hạn hoặc chuyển nhượng thực tế.

Thứ tự khuyến nghị: Xác thực → Kiểm tra khả dụng → Định giá → Số dư → Xử lý phản hồi → Thao tác thực tế.
14 Tôi có thể kiểm tra nhiều tên miền trong một yêu cầu API không?

Có. Điểm cuối Kiểm tra tình trạng khả dụng của tên miền hỗ trợ nhiều tên miền được phân tách bằng dấu phẩy.

example.com,example.net,example.org

Không giả định rằng mọi thao tác API đều hỗ trợ cùng một định dạng đầu vào nhiều tên miền. Việc đăng ký, gia hạn và chuyển nhượng phải tuân theo tài liệu riêng của từng điểm cuối.

15 Làm cách nào để tra cứu giá đăng ký, gia hạn và chuyển nhượng?

Sử dụng điểm cuối Get Domain Pricing. Các loại giá trong tài liệu bao gồm register, renew, transfer và all.

Phản hồi đăng ký cũng có thể bao gồm giá trị is_premium cho biết bản đăng ký được truy vấn có thuộc diện cao cấp hay không.

Do đơn hàng API sử dụng định giá theo cấp độ tài khoản, hãy truy vấn giá hiện tại trước khi gửi đơn hàng trả phí của khách hàng thay vì dựa vô thời hạn vào giá đã lưu trong bộ nhớ cache.

16 Mọi TLD có thể được đăng ký hoặc gia hạn với thời hạn 1–10 năm không?

Không. Mặc dù tài liệu API hỗ trợ thời hạn lên tới 1–10 năm cho các phần mở rộng áp dụng, từng TLD có thể có các quy định vận hành khác nhau.

Thời hạn đăng ký, thời hạn gia hạn, điều kiện chuyển nhượng, yêu cầu về thông tin liên hệ và yêu cầu xác minh có thể khác nhau tùy theo phần mở rộng. Ứng dụng của bạn nên tuân theo các quy định hiện hành cho TLD liên quan.

17 Sự khác biệt giữa máy chủ tên, bản ghi DNS và máy chủ tên con là gì?
Máy chủ tênXác định nơi DNS có thẩm quyền của một tên miền được ủy quyền.
Bản ghi DNSQuản lý các bản ghi trong một vùng DNS khi sử dụng dịch vụ DNS của NiceNIC.
Máy chủ tên conTạo bản ghi host/glue như ns1.example.com.

Đây là các thao tác riêng biệt và không nên được coi là có thể thay thế cho nhau.

Phản hồi và lỗi

Xử lý chính xác các trạng thái thành công, đang chờ xử lý và thất bại.

4 câu hỏi
18 Các mã phản hồi API có ý nghĩa gì?
MãÝ nghĩa
0Thành công
201Đang chờ xử lý
400Lỗi tham số
401Chưa xác thực
404Không tìm thấy bản ghi liên quan
500Lỗi nội bộ máy chủ

Luôn sử dụng mã và thông báo trả về khi xác định trạng thái của một yêu cầu API.

Xem các mã phản hồi API →

19 Mã 201 có nghĩa là gì?

Phản hồi 201 có nghĩa là thao tác đã được chấp nhận để xử lý nhưng không nhất thiết đã đạt đến trạng thái cuối cùng.

Quan trọng: Không coi phản hồi đang chờ xử lý là thành công cuối cùng. Hãy giữ nguyên trạng thái đang chờ xử lý cho đến khi kết quả cuối cùng của thao tác tên miền được xác nhận.
20 Điều gì xảy ra khi đăng ký tên miền trả về mã 201?

Khi đăng ký tên miền, phản hồi 201 cho biết đơn hàng đã được gửi và đang chờ cơ quan đăng ký tên miền xử lý cuối cùng.

Không thông báo với khách hàng cuối rằng tên miền đã hoạt động cho đến khi hệ thống của bạn xác nhận kết quả cuối cùng. Hãy làm theo tài liệu về endpoint đăng ký để nắm các quy tắc mới nhất về xử lý đơn hàng đang chờ và hoàn tiền.

21 Phản hồi chuyển nhượng đang chờ xử lý có nghĩa là gì?

Chuyển nhượng đang chờ xử lý có nghĩa là yêu cầu chuyển nhượng đã được chấp nhận để xử lý, chứ không phải tên miền đã hoàn tất chuyển nhượng sang NiceNIC.

Việc hoàn tất chuyển nhượng có thể phụ thuộc vào quá trình xử lý của cơ quan đăng ký tên miền và nhà đăng ký, cũng như trạng thái chuyển nhượng hiện tại của tên miền. Hãy giữ chuyển nhượng ở trạng thái đang chờ xử lý cho đến khi xác nhận hoàn tất.

Danh mục tên miền, Tuân thủ và Tích hợp

Quản lý danh mục tên miền và kết nối hệ thống hiện có.

3 câu hỏi
22 Tôi có thể truy xuất và lọc danh mục tên miền của mình thông qua API không?

Có. API Liệt kê tên miền hỗ trợ truy xuất danh mục với các tùy chọn phân trang, sắp xếp và lọc.

Sử dụng Xem chi tiết tên miền khi bạn cần thông tin chi tiết về một tên miền cụ thể, chẳng hạn như thông tin đăng ký, thông tin hết hạn, máy chủ tên và dữ liệu liên hệ của tên miền.

23 API Lạm dụng & Tuân thủ có thể làm được gì?

API tên miền NiceNIC v2 bao gồm các thao tác Lạm dụng & Tuân thủ được thiết kế cho các nền tảng và nhà bán lại quản lý danh mục tên miền của khách hàng.

Bạn có thể xác định các tên miền liên quan đến báo cáo lạm dụng và truy xuất thông tin tuân thủ máy đọc được cho từng tên miền. Tùy từng trường hợp, phản hồi có thể bao gồm trạng thái tên miền, mức độ ảnh hưởng hiện tại, hành động đề xuất, thông tin tạm giữ, thông tin khiếu nại và các URL được báo cáo.

Điều này cho phép hiển thị trạng thái tuân thủ trực tiếp ngay trong cổng thông tin khách hàng hoặc hệ thống vận hành của bạn.

24 Tôi có thể sử dụng NiceNIC Domain API v2 với WHMCS không?

Có. NiceNIC cung cấp tích hợp registrar WHMCS dành cho các doanh nghiệp đã sử dụng WHMCS để lập hóa đơn và cấp phát dịch vụ.

Sử dụng Domain API v2 trực tiếp khi bạn đang xây dựng ứng dụng hoặc quy trình làm việc của riêng mình. Sử dụng tích hợp WHMCS khi bạn muốn các thao tác tên miền được tích hợp vào môi trường WHMCS hiện có.

Xem tích hợp WHMCS →

Phát triển và hỗ trợ

Xây dựng an toàn và biết nên gửi gì khi cần hỗ trợ.

4 câu hỏi
25 Tôi có thể sử dụng những ngôn ngữ lập trình nào?

Bất kỳ ngôn ngữ lập trình hoặc môi trường chạy nào ở phía máy chủ có khả năng gửi yêu cầu HTTPS và phân tích cú pháp JSON đều có thể tích hợp với API tên miền v2.

Các lựa chọn phổ biến bao gồm PHP, Python, Node.js và Java. Hãy giữ thông tin xác thực API ở phía máy chủ và không bao giờ tiết lộ bí mật API của bạn trong JavaScript phía trình duyệt hoặc mã phía máy khách có thể tải xuống.

26 Có giới hạn tần suất API không?

Giới hạn tần suất có thể được áp dụng để bảo vệ tính ổn định của API và bảo mật nền tảng.

Nếu hệ thống tích hợp production của bạn dự kiến tạo ra khối lượng yêu cầu cao liên tục, hãy liên hệ NiceNIC trước khi triển khai để mô hình sử dụng dự kiến của bạn có thể được xem xét.

27 Khi liên hệ bộ phận hỗ trợ về một vấn đề API, tôi nên cung cấp những thông tin gì?

Hãy cung cấp thời điểm gửi yêu cầu, loại API và thao tác, tên miền (nếu có), các tham số yêu cầu không nhạy cảm, mã phản hồi và thông báo được trả về, đồng thời cho biết yêu cầu được gửi từ môi trường thử nghiệm hay môi trường thực tế.

Tuyệt đối không cung cấp toàn bộ khóa bí mật API của bạn trong phiếu hỗ trợ thông thường.

Gửi phiếu yêu cầu hỗ trợ →

28 Tôi có thể tìm tham số yêu cầu đầy đủ và ví dụ mã ở đâu?

Sử dụng mục điều hướng API trong tài liệu. Mỗi thao tác có một trang riêng trình bày các tham số được hỗ trợ, ví dụ về yêu cầu, ví dụ về phản hồi và hành vi đặc thù của thao tác đó.

FAQ giải thích hành vi chung của API; tài liệu về từng endpoint cụ thể phải được coi là nguồn tham chiếu chính xác cho định dạng yêu cầu.

Mở Tài liệu API →

Không tìm thấy câu hỏi phù hợp Hãy thử từ khóa ngắn hơn như “thử nghiệm”, “bảng giá”, “chuyển nhượng” hoặc “201”.

Bạn đã sẵn sàng bắt đầu xây dựng chưa?

Kiểm tra tích hợp của bạn trong môi trường thử nghiệm API, sau đó kết nối tài khoản NiceNIC khi bạn sẵn sàng chuyển sang môi trường sản xuất.

Copyright © 2006–2026 NICENIC INTERNATIONAL GROUP CO., LIMITED. All Rights Reserved.